| Table of Contents |
|---|
How to Start
Shared Timeline enables Jira users to share their Jira timelines with external stakeholders.
Users can customize their timelines by selecting specific issues to designate as epics. For example, you can create a timeline consisting of issue types like "Bugs" as epics and display their subtasks on the timeline as well. This functionality allows users to tailor their timelines creatively, showcasing various types of tasks to meet their specific needs.
When creating an External Share, ensure that you have selected Timeline as the share type.
| Info |
|---|
To create an external share, please refer to Getting Started. |
After creating a share, you will see the preview window on the left and the Share Configuration options on the right.
After creating Shared FilterTimeline, user can:
Subscribe to issues displayed on the timeline
Filter the view by assigned user, status, or designated epic
View the timeline by weeks, months, or quarters
Center the view to "Today" with just one click
Note that this share type is available on project level and operates differently from what you may expect. Rather than displaying a copy of your existing timeline, it creates a new one from scratch using JQL.
Default JQL definition is pre-set during creation, mimicking Jira's default timeline configuration. However, you can customize your timeline to suit your specific requirements.
Customizable Options
On the right side of the window, you'll find various configuration options, which include:
General, Permissions, Security, Custom fields, Custom content, Extensions, Quick Filters, Filter Timeline Configuration
| Note |
|---|
Please note that the available configuration settings categories may vary depending on the Share Type you select. (Issue, Board, Filter, or Timeline) |
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: The description is also 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
Enable share: if disabled, external user won’t be able to access the link.
Project: Select the project you want to share externally.
Share type: Choose the share type as Filter.Timeline
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.
Permissions
Permissions tab allows you to define what information and actions are accessible when sharing a Filter Timeline 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.
Regarding the secret password that enables auto-login to Password Protected External Share links, please refer to Programmatical Share Access Token.
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.
Custom fields
You can select custom fields to display on the shared link, such as status category changed, sprint, epic name, project, and more.
Custom content
You can customize the header and footer text to suit your needs. Text will be displayed as above.
Extensions
Enable/disable integrations with extension plugins.
Quick Filters
You can add your custom quick filters to a shared filter.
Once these quick filters are added to the shared filter, external users will see them as clickable options.
From left image, two Quick Filters are defined:
Open
status != DoneIn practice, clicking this filter will hide all completed issues and display only issues that are still in progress, new, or need attention.
Recently Updated
updated >= -1dThis filter shows all issues that were updated within the last day.
By selecting a custom quick filters, external users can focus on the issues that meet those conditions.
Board configuration
Timeline configuration
Add filters that you want to enable on the shared filterTimeline.
For example, if the Labels Once Assignee filter is enabled, external users will be able to view and filter issues by labels assignees directly from the shared filtertimeline.