Skip to main content

Link Expiration

Every public link β€” Work Item, board or filter β€” can be given an expiry date. Once it passes, the link stops working everywhere, immediately.

Administrators can go further and set a default expiry for all new links, and a maximum lifetime that nobody can exceed.

Why Set an Expiry​

A public link has no password by default and never asks who is opening it. Left alone, it keeps working for as long as the app is installed β€” long after the client review, the vendor engagement or the incident it was created for has finished.

An expiry turns "someone should remember to revoke this" into something that happens on its own. It is the single most effective control in the app, because it is the only one that does not depend on anyone remembering anything.

Setting an Expiry​

The control is in the Security section of every sharing dialog, labelled Link expires:

OptionBehaviour
NeverThe link works until sharing is turned off manually
24 hoursExpires exactly 24 hours from the moment you save
7 days / 30 days / 90 daysExact multiples of 24 hours from the moment you save
Custom date…Expires at the end of the date you pick

The picker shows both the exact date and a relative summary ("in 7 days"), so there is no ambiguity about what you have chosen.

tip

Custom date runs to the end of that day. Choosing 31 December means the link still works all day on the 31st and stops at 23:59:59 your local time β€” not at midnight that morning. Picking today is allowed and gives you a link that dies tonight.

An expiry can be added, changed or removed at any time by reopening the dialog and saving β€” you do not have to create a new link to change when it dies.

Expiry is checked at the moment someone tries to use the link. There is no delay and no background job to wait for.

WhereWhat happens
Someone opens the URLA "Link Expired" page, telling them the link is no longer available
A tab that was already openThe next action fails and the page swaps to a "this link has expired" notice
The sharing dialog, back in JiraA warning panel offering to extend the same link or replace it
Admin overview tablesAn Expired label in the Expires column

The Copy, Open and QR code buttons disappear while a link is expired. Handing someone a URL that no longer works is worse than offering no button at all.

Expired links are not deleted. The record stays so you can revive it β€” see below β€” and so administrators can still see what was shared and clear it up.

When you reopen the dialog for an expired link, you have two options, and the difference matters:

Extend it β€” pick a new expiry and save. The same URL starts working again. Anyone who still has the old link regains access. Choose this when the link is simply still needed.

Replace it with a new URL β€” the old URL never works again, whoever holds it. Choose this when the link may have been forwarded further than you intended, or when the audience has changed.

How you replace it depends on what is shared:

Share typeHow to replace
Work Item, boardThe expired-link warning offers a Create a new link button, which does both steps for you
FilterRevoke the expired link from your list, then create a new one

Administrator Settings​

Both settings live under Jira Settings β†’ Apps β†’ Share Public Link β†’ Sharing Policy, in the Link Expiry Policy section.

Pre-selects an expiry whenever anyone creates a new link. The person sharing can still change it, including back to Never.

This is a nudge, not a control. Its value is that the safe option becomes the one people get by not thinking about it.

Maximum lifetime​

A hard ceiling. Nobody can create or edit a link to last longer than this, and while it is set "Never" is not available to anyone β€” that is the entire point of the setting.

If someone requests a longer expiry than the cap allows, the link is saved with the cap instead, silently.

Reviewing Expiries Across the Site​

The Shared Work Items, Shared Boards and Shared Filters tabs of the admin page each have an Expires column showing, per link:

  • the exact expiry date, or Never
  • a highlight when a link expires within the next 24 hours
  • an Expired label for links whose date has already passed

This is the fastest way to find links that will outlive their purpose β€” sort by the column and look at everything reading Never.


FAQ​

No. Expiry only affects the public link. Nothing in Jira is touched, and nothing shared is deleted.

No. The shared page does not show an expiry date. Recipients only find out when it stops working, so tell them yourself if the deadline matters to them.

What timezone is the expiry in?​

Stored as an exact moment in time, so it expires simultaneously everywhere. A custom date is interpreted as the end of that day in the timezone of whoever picked it; the fixed periods are exact multiples of 24 hours from the moment of saving.

If I change the expiry, does the URL change?​

No. Changing an expiry keeps the same URL β€” that is what makes extending an expired link hand access back to everyone who had it. Only replacing the link gives you a different URL.

For Work Items and boards, yes β€” anyone who can open the sharing dialog can edit the active link, since there is one link per Work Item or board. For filters, only the person who created a link can edit it; administrators can revoke any of them.

No. They serve no content and consume no quota. They remain listed only so they can be revived or cleaned up.

No. Setting a maximum lifetime caps everything created or edited from that point on, but existing links have to be revoked individually from the admin tables.