General Options | Share Configuration
To create external share content, you can follow the guide How to Create an External Share Link.
When creating external share content, you will see a variety of configuration options. These allow you to set everything from basic details, like the share link name, to more advanced settings such as which information and actions will be accessible when sharing Jira content via a link with external viewers.
The table below provides an easy overview of which configuration options are available for each type of share content. On this page, we will look at five general options—General, Issue Fields and Permissions, Security and Extensions—which apply to all four types of share content.
For the remaining options, please refer to the page that corresponds to the specific share content type you are using.
Configuration Option | Shared Issue | |||
---|---|---|---|---|
General | ✓ | ✓ | ✓ | ✓ |
Issue Fields and Permissions | ✓ | ✓ | ✓ | ✓ |
Security | ✓ | ✓ | ✓ | ✓ |
Extensions | ✓ | ✓ | ✓ | ✓ |
Custom Content |
| ✓ | ✓ | ✓ |
Quick Filters |
| ✓ | ✓ |
|
Board Configuration |
| ✓ |
|
|
Filter Configuration |
|
| ✓ |
|
Timeline Configuration |
|
|
| ✓ |
General
General tab allows you to edit and define the core settings of the external share link.
Name: The link name is for internal reference only and will not be shared with the external link.
Description: It’s for internal use and will not be visible in the shared link.
Use Public URL: The link name value will be used to prepare named link. A public link is easy to access and accessible to anyone.
Enable share: if disabled, external user won’t be able to access the link.
Project: Select a Jira project. Every share link live under some Jira project. Once link is under Jira project, different project configuration rules are applied upon a share.
Share type: Choose the share type.
JQL: Use JQL (Jira Query Language) to define the specific data you want to include. You can find more information about JQL Here.
Adjust issue layout: Choose a customized layout, which can be set up in Global Settings.
Actor: Actor is a person who determines what data will be displayed on shared view based on actor permissions. Actor is initially set as the creator but can be managed by admins or specified via API.
Issue Fields and Permissions
Issue Fields and Permissions tab allows you to define what information and actions are accessible when sharing a Jira content via a link for external viewers.
For example, you can configure settings so that external viewers can view or add comments, attachments, linked issues, sub-tasks, status, changelogs, and approvals. You can also allow them to make changes to the issue summary and description.
Simply clicking the X button removes it, and the external viewer will no longer be able to view, add, or change content.
For parent-level configurations, these settings can be managed directly in Project Configuration.
Security
Enable password protection : Set a password to restrict access to the shared content. Only external viewers with the password will be able to access the external share.
Set link expiration time: Define an expiration date and time for the link by clicking the calendar icon.
Require SSO : Enable corporate SSO for added security. Follow the SAML / SSO - Setup guide for setup instructions.
Share with specific emails or domains: Specify individual email addresses or email domains to restrict access.
Display comments with restrictions: Comments can be restricted to specific roles or groups.
Regarding the secret password that enables auto-login to Password Protected External Share links, please refer to Programmatical Share Access Token.
Extensions
You can enable/disable Right To Left (RTL) languages support