Comment Default Visibility for Jira – Setup Guide
This guide walks you through installing and configuring the Comment Default Visibility app on your Jira Cloud site.
1. Install the app
- In Jira, go to Settings (gear icon) → Apps → Find new apps (or Manage apps → Find new apps).
- Search for Comment Default Visibility (or Comment Default Visibility for Jira).
- Click Install and follow the prompts.
- Accept the requested permissions when prompted.
Screenshot: Capture: Jira Settings → Apps → search results showing the app, or the app’s install/configuration screen.

2. Open the configuration page
- Go to Settings (gear icon) → Apps → Manage apps.
- Find Comment Default Visibility (or Comment Visibility) and click it.
- The app opens its configuration page titled Comment default visibility.

3. Configure the global default
The global default applies to all projects unless overridden.
- In the Global default section, choose a Visibility scope:
- Internal (Jira users only) – Only Jira users can see the comment.
- Group – Only members of a specific Jira group can see it. Select the group from the dropdown.
- Project role – Only users with a specific project role can see it. Select the role (roles are from your first project; for project-specific roles, use project overrides).
- If you choose Group or Project role, ensure the group/role has members. The app will warn you if it appears empty.
- Click Save at the bottom of the page.

4. Add project overrides (optional)
Use project overrides when some projects need a different default visibility.
- In the Project overrides section, click the Choose a project dropdown.
- Select a project that does not yet have an override.
- Choose the scope type (Internal, Group, or Project role) and, if needed, the group or role.
- Click Add override.
- Repeat for other projects as needed.
- Click Save.

5. Add component overrides (optional)
Use component overrides when certain components should have a different default visibility than the project.
- In the Component overrides section, select a project from the dropdown.
- Select a component from that project (only components without an override are shown).
- Choose the scope type and, if needed, the group or role.
- Click Add override.
- Repeat for other components as needed.
- Click Save.

6. Backup and restore (optional)
You can export your configuration as JSON and import it later (e.g. after reinstalling or on another site).
- Click Export config to copy the JSON to the text area.
- To restore, paste JSON into the import field and click Import config.
- Click Save after importing.

7. Where the app appears in Jira
After configuration, the app shows up in these places:
| Location | What you see |
|---|---|
| Issue sidebar | A „Comment scope“ panel showing the effective default visibility for the current issue. |
| Issue panel | An „Add comment“ panel with a visibility dropdown and comment editor. |
| Issue actions | An „Add comment“ action that opens a modal to add a comment with the default visibility. |
Screenshot: Capture: An issue view with the „Comment scope“ panel visible in the right sidebar.


8. Scope resolution order
The app applies visibility in this order (first match wins):
- Component override – If the issue has a component with an override, that is used.
- Project override – If the project has an override, that is used.
- Global default – Otherwise, the global default is used.
If the user is not a member of the configured group or role, the comment stays public (no visibility restriction).
9. Troubleshooting
| Problem | What to check |
|---|---|
| License required | The app requires a valid license. Check your Atlassian Marketplace subscription. |
| No groups/roles in dropdown | The visibility dropdown only shows groups and roles you belong to. |
| Comment failed: not a member of group | The selected visibility (group or role) has no members you’re in, or the group/role is misconfigured. |
| Default not applied | Confirm the scope has members and that you’re in that group or role. |
| Admin page not found | Go to Settings → Apps → Manage apps and open the app from there. |