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.
Configuration Option | Issue (work item) Share | Board Share | Filter Share | Timeline Share | Redirect Share | Attachment Share |
|---|---|---|---|---|---|---|
General | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Permission | ✓ | ✓ | ✓ | ✓ |
|
|
Security | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Custom Content (custom header and footer) |
| ✓ | ✓ | ✓ |
|
|
Quick Filters |
| ✓ | ✓ |
|
|
|
General
General tab allows you to edit and define the core settings of the external share link.
Link name: The link name is for internal reference only and will not be shared with the external 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.
Description: It’s for internal use and will not be visible in the shared link.
Enable share: if disabled, external user won’t be able to access the link.
Project: Select a Jira project (space). 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.
Enable Voting: An “Enable voting” toggle is available on issues, filters, boards, and timelines share types, allowing external users to vote on individual issues (work items) when viewing shared content.
Enable Issue creation: An “Enable Issue creation” toggle is available on issue, filter, board, and timeline share types, allowing external users to create a new work item in the same space that is selected in Project field selector.
You can enable/disable Right To Left (RTL) languages support
Permission
Permission 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, time tracking 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 users: Specify individual email addresses or email domains to restrict access.
Display comments with restrictions: pick roles or groups to exclude from comments.
Show only comments created after chosen date: It allows displaying only comments created after a selected date.
Regarding the secret password that enables auto-login to Password Protected External Share links, please refer to Programmatical Share Access Token.
Work item creation
When the "Enable Issue creation" option is active, a "Create Issue" button appears on the external share view. Clicking this button opens a form containing all available fields. Once submitted, the new work item is immediately created in the linked Jira space.
Automation and metadata
To help you track the source of these tickets, the system automatically attaches metadata to every work item created through an external share. This data is stored as an Issue Property named share and can be accessed via Jira Automation or the REST API.
Metadata Structure
The share property object contains the following fields. Note that multiple context fields (like issueId and boardId) may be present simultaneously depending on where the user was located within the share when they created the work item.
Field Name | Availability | Description |
|---|---|---|
| Always present | UUID of the share link used to create the work item. |
| Always present | ID of the share link. |
| Conditional | Present if the user initiated creation while viewing a specific work item (also inside an Issue view within a Board, Timeline or Filter share). |
| Conditional | Present if the share type involves a board (e.g., Board share). Can appear alongside |
| Conditional | Present if the share is defined by a jql query (e.g., Filter, Timeline, or Custom Board shares). Can appear alongside |
| Conditional | The ID of the logged-in external user (if applicable). |
| Conditional | The email of the logged-in external user (if applicable). |
| Conditional | The display name of the logged-in external user (if applicable). |
This metadata can be retrieved using the Jira REST API at the following endpoint: GET /rest/api/3/issue/{issueKeyOrId}/properties/share
(Replace {issueKeyOrId} with the actual Key or ID of the newly created work item.)
Example Payload
{
"key": "share",
"value": {
"uuid": "a1b2c3d4-e5f6-7890",
"id": "12345",
"boardId": "55",
"issueId": "1001",
"externalUserId": "1",
"externalUserEmail": "user@example.com",
"externalUserDisplayName": "Jane Doe"
}
}