-
-
Notifications
You must be signed in to change notification settings - Fork 7
Settings Profiles
Profiles are reusable configuration templates for repositories and projects. Instead of configuring each repository or project individually, you define settings once in a profile and assign it to multiple repositories or projects.
There are two types of profiles:
Control how issues and pull requests are tracked for repositories:
| Setting | Description |
|---|---|
| Track Issues / PRs | Enable or disable tracking |
| Update Mode | None, Update, or Append |
| Folder | Storage path for files |
| Filename Template | Filename pattern (see Filename-Templates) |
| Content Template | Custom content template (see Content-Templates) |
| Include Comments | Include issue/PR comments |
| Include Closed | Track closed issues/PRs |
| Allow Deletion | Auto-delete when closed or filtered out |
| Include Sub-Issues | Include GitHub sub-issues |
Control how project items are stored and displayed:
| Setting | Description |
|---|---|
| Issue / PR Folder | Folder path (supports {project} variable) |
| Filename Template | Filename pattern for issues and PRs |
| Content Template | Custom content template |
| Skip Hidden Statuses | Don't sync items with hidden status columns |
| Show Empty Columns | Display empty Kanban columns |
| Include Sub-Issues | Include GitHub sub-issues |
The plugin comes with two built-in default profiles:
- Default (Repository) - Used for all repositories unless changed
- Default (Project) - Used for all projects unless changed
Default profiles can be edited but not deleted.
- Go to Settings > Profiles
- Click the + button in the profile toolbar
- Enter a name for the profile
- Select the type: Repository or Project
- Configure the profile settings
Click the copy button to create a copy of the currently selected profile. The copy will have the same settings with "(Copy)" appended to the name.
Select a custom profile and change its name in the text field below the dropdown.
Click the trash button to delete a custom profile. Any repositories or projects using this profile will be reassigned to the default profile.
When adding a new repository, select a profile from the dropdown. You can also change the profile of an existing repository in its settings under Repository-Settings.
When adding a new project, select a profile from the dropdown. You can also change the profile of an existing project in its settings under Project-Settings.
- Create a profile "Work Projects" with specific folder paths, update mode, and a custom content template
- Create a profile "Open Source" with different settings
- Assign "Work Projects" to your company repositories
- Assign "Open Source" to your open source repositories
- When you change a profile, all assigned repositories update automatically