Insert a Step Library collection when a Test Case needs a procedure your team maintains in one place. For example, reuse the same sign-in steps before testing checkout, account settings, or order history.
Before you begin
Save the Test Case and any script edits before opening Step library.
Check the Test Case key and version you want to change.
Use a collection shared with the Test Case’s Jira space, with the same script format.
Your account needs the relevant Test Case view and edit permissions.
If you need a collection first, follow Create Reusable Test Steps in the Step Library.
Insert a Multi Steps collection
Open the Test Case and select Test Script.
Select Step library from the script toolbar.
Find the collection. Expand its preview or open it to check the instructions before inserting.
Select the collection in the library list and choose Insert Collection.
Under Insert at, choose a position such as Before step 3 or End of script.
Confirm with Insert Collection, then review the refreshed Test Case script.
When inserting from an open collection’s details, use Insert collection. Review the resulting position; the selection toolbar can supply a position based on your selected script items.
Check the order
Order | Example content |
1 | Open the test site. |
2–3 | Shared “Sign in as a registered shopper” collection. |
4 | Add a product to the cart. |
5 | Confirm the cart shows the selected product. |
Keep each collection together as one block. Insert or move it before or after another collection, rather than between that collection’s steps.
You can select several collections; Vansah inserts them in selection order. A Multi Steps script can contain at most 200 steps after insertion, including the steps inside collections.
Move or remove the block
Open Collection options on the shared block. Choose Move to change its position, or Remove from script to remove that occurrence from this Test Case version.
Removing a Multi Steps reference removes its steps from this script. The collection remains in the Step Library for other cases. This is separate from deleting the collection itself.
If the same collection is already present, Vansah asks whether to insert it again. Confirm only when the procedure is intentionally repeated, such as signing in with a second account.
Using a Plain Text collection
A Plain Text collection replaces the destination version’s whole Plain Text script. Select one compatible collection and review the Replace script with collection confirmation before selecting Replace script.
Save or export any instructions you still need before replacing them. This action changes the selected Test Case version’s script.
If insertion fails
Check the selected case version, script format, and collection sharing.
Open the collection and confirm it contains saved instructions.
If the position is no longer available, refresh the script and choose a current position.
If the 200-step limit is reached, reduce the procedure or divide it into smaller Test Cases.
Inserting a collection references shared content. If you need to reuse a whole Test Case’s script instead, see call a Test Case within a test script.