Share a Step Library collection when several Jira spaces need the same test instructions. You can keep it in its owning space, make it available across the Jira site, or select specific spaces.
Understand the sharing options
Library label | Sharing selection | Where it is available |
Local | Current space | The collection’s owning Jira space. |
Global | All spaces in this Jira site | Spaces in the same Jira site, subject to each user’s access and Vansah permissions. |
Selected spaces | Selected spaces | The selected spaces, plus the owning space. |
Global does not make the collection public on the internet. Sharing does not grant Jira space access or bypass Vansah permissions.
Before you change sharing
Open the collection in its owning Jira space. You need the relevant Test Case edit permission there to change sharing. The collection’s space key identifies its owner; use Information in the collection’s more options menu if you need to check its details.
Review the collection’s Traceability tab and its usage before widening or narrowing access. The usage list is limited to cases you can access.
Choose where to share
Open Step Library and select the collection.
Open the collection’s more options menu and select Sharing. Sharing is also shown under Traceability.
Under Available in, choose Current space, All spaces in this Jira site, or Selected spaces.
For Selected spaces, select at least one destination. Check both the space key and name.
Select Save. Use Cancel to discard your sharing changes.
Reopen the sharing view and check the saved selection. Ask an authorized user in a destination space to confirm the collection is available.
For example, share a common sign-in collection with SHOP and MOBILE when those teams follow the same procedure. Use separate collections when their instructions differ.
Know who can change what
Action | Access to check |
Open or insert the collection | It must be shared with the viewing space, and the user needs the applicable case view or edit permission. |
Edit shared instructions | The user needs Test Case edit permission in a space where the collection is available. Edits affect shared content. |
Change sharing | Open the owning space and have the required edit permission there. |
Delete the collection | Use the owning space and the applicable delete permission; live references must be addressed first. |
A shared collection is not automatically read-only. Agree on who maintains it before sharing common instructions across teams.
Review existing references separately
Changing sharing updates the collection’s availability. It does not automatically remove references already inserted into Test Cases or delete earlier Test Runs. Review those case scripts separately if the collection should no longer be used there.
If a collection is missing, check the current Jira space, sharing selection, filters in the Step Library list, and the user’s permissions.