ContentsππΌ
Linked Templates are an advanced type of Smart Checklist templates designed to create and sustain a dynamic link with related issues when imported. Unlike the regular (non-linked) templatesΒ that involve adding a snapshot of the template during import into the checklist, Linked Templates directly import the live template instance.
Main Highlights:
π Live Connection: Linked Templates stay connected to associated issues, ensuring instant updates and synchronization.
π Immutability: Users can't make changes to the imported Linked Templates, other than changing the status of items.
π Synchronized updates: Admins can update the original template, automatically reflecting changes across all checklists where the template is imported to.
You can create a Linked Template by:
creating a new template from the Smart Checklist settings
converting the existing template into a Linked Template
Create a Linked Template
Click on Settings icon upper right corner of the page β Select βManage Appsβ menu item β Click on Settings link under Smart Checklist section in the left menu β Click on Templates tab
Click the β+ Add Newβ button
In the dialogue that appears, enable the βLinkedβ switcher.
Add checklist items as needed.
Select Scope.
Add Default Template Conditions is needed.
Convert a Template to Linked
You can convert a template to Linked and vice versa.
On issue view page open the βManage Templatesβ menu
Click on the template you want to convert.
Enable the βLinked Templateβ switcher
Import the Linked Template
Importing Linked Templates is as simple as importing a regular template. Follow these steps:
Navigate to your Jira Issue and open the Smart Checklist menu.
Choose "Import from a template."
Select the template you want to add to your Jira issue and click "Import."
Once imported, your linked template will appear in your issue, separated from your main checklist.
To view all linked issues, go to βManage Templatesβ β expand the template β click the βView linked issuesβ link in the right sidebar.
For unlinking a template from an issue, please refer to the relevant section in the documentation.
βπΌNOTE: You can import the same Linked Template only once per issue. If the template is already linked to an issue, the βImportβ button will be disabled.
βπΌNOTE: After the import the template will be linked with its original copy. Any changes made to the original template, will affect every checklist where the template is imported to.
βπΌNOTE: Users can only change the statuses of items in the imported linked template.
Set Linked Template as Default
Similar to regular templates, you can set Linked Templates as default for automatic import when a specific issue type is created.
π‘ HINT: For detailed instructions, please refer to the complete guide here β Set a Template as Default
Edit a Linked Template
Any changes made to a Linked template will automatically reflect in every checklist where the template has been imported. Our app keeps track of every single item in the template and its status in the issues where it was imported.
To edit the linked template:
Open the βManage Templatesβ menu, accessible from either the Issue view or Project Settings.
Click on the template name to expand the details.
Select "Edit" to enter editing mode.
Make the desired changes to your template.
Click the βSaveβ button to apply the changes to your template. Same changes will be applied to every checklist where the template is imported to.
βπΌNOTE: The Full-screen editor is not available for editing the Linked Templates
βπΌNOTE: Modifying the status of an item in the original linked template will not overwrite the status of corresponding items in the imported instances.
Removing a Linked Template
There are several ways to remove Linked Templates from the Smart Checklist:
Unlink a Template from a Single Issue
Convert a Template to Non-Linked
Delete a Linked Template
These options offer you the flexibility to either entirely remove the linked template from your issues or remove the link while keeping the associated items.
Unlink a Template from a Single Issue
To unlink a template from a specific issue, follow these steps:
Navigate to the Issue view.
Click on the three-dot menu near your Linked Template.
In the three-dot menu, you'll find two options:
βUnlink template and keep itemsβ: Linked template items and their statuses will be appended to your main checklist.
βUnlink template and remove itemsβ: The Linked template will be completely removed from the issue.
Choose the appropriate option, and the template will be successfully unlinked from the issue.
Convert a Template to Non-Linked
To convert a template to non-linked, follow these steps:
Open the βManage Templatesβ menu.
Click on the three dots next to the template you want to convert.
In the opened menu, choose "Convert to non-linked."
In the subsequent dialogue, decide whether you want to βKeepβ or βRemoveβ the checklist items from all the issues where the linked template was imported.
Click "Convert to non-linked" to confirm.
Now, your template is ready for use as a regular template.
Delete a Linked Template
To delete a template, use the following steps:
Open the βManage Templatesβ menu.
Click on the three dots next to the template you want to delete.
In the opened menu, choose "Delete."
In the subsequent dialogue, decide whether you want to βKeepβ or βRemoveβ the checklist items from all the issues where the linked template was imported.
Click "Delete" to confirm.
By following these steps, you can efficiently unlink, convert or delete your templates based on your needs.
History events for Linked Templates
All the changes done for the Linked Templates imported to the issues will be tracked in the Smart Checklist History tab. Please find the newly added events in the table below:
Operations with Linked templates | Events in the Smart Checklist History tab |
---|---|
Edit Linked Template | edited the linked "Template name" template |
Rename a Linked Template | renamed the linked "Old template name" template to "New template name" |
Link (Import) the Linked Template to the issue | linked a "Template name" template |
Unlink the Linked template (and keep/remove items) | unlinked a "Template name" template, and appended/removed items |
Convert Linked Template to non-linked (and keep/remove items) | The "Template name" template has been unlinked, and items have been appended/removed from the checklist |
When linked templates are automatically assigned to any issue type | The checklist has been created |
Change status for items of the linked template in the issue view | changed the item |
Delete a Linked Template (and keep/remove items) | The "Template name" template has been unlinked, and items have been appended to/remove from the checklist |
π‘ HINT: Find the complete list of events here β Smart Checklist History tab
Assigned items and notifications
Similar to regular operation available for checklist items - you can assign a user to a checklist item in a Linked Template.
Once you import a Linked Template to an issue that contains a checklist item with a user mention, an item will be added to the Smart Checklist Pro items page.
Users who have been mentioned in a Linked Template checklist will receive an email notification once the items from it are imported into an issue.
βπΌNOTE: You need the Notify Checklist Assignees by Email feature to be enabled for this to work.
Linked Templates in the Checklists custom field
βπΌNOTE: The Linked Template may be only edited from a Template Manager.
If you have custom field Checklists added to any of the screens, items imported from any linked template will be displayed but couldnβt be updated via this field.
Erasing the entire checklist or the linked template, or making any changes to the items imported from a Linked template in the custom field Checklists does not unlink the template nor remove/update it.
Items imported from a linked template will be displayed like this in the Checklists custom field:
Linked Templates and Jira Automation
βπΌNOTE: From version v2.5.67-AC, users can fully use the Linked Templates functionality in connection with Jira Automation.
If you need to add Linked Template to any Jira Automation scenario you can copy Linked Template id as any regular Template id and add it to Jira Automation scenario. After scenario is properly added and activated you can get all the benefits of the Linked Template in cooperation with Automation. For example, you can add a new item to a linked template and it will be immediately displayed in the checklist assigned to the Jira task. Detailed instruction how to use templates in automation.
Coming soon π₯
Components library DELETE BEFORE PUBLISHING! | |
---|---|
Read more details on KB components and regulation here β https://railsware.atlassian.net/wiki/pages/createpage.action?spaceKey=SC&title=KB%20Regulation | |
Info note | βπΌNOTE: info message |
Warning note | βπΌNOTE: warning message |
Hint | π‘HINT: hint message |
Permissions required | π€ JIRA PERMISSION REQUIRED: grant users [Permission] to [action] π€ APP PERMISSION REQUIRED: grant users [Permission] to [action] More about permissions here β Checklist & Templates Permissions |
Longread | Contents ππΌ |
Emojis | β π π₯³ ππΌ ππΌ β π π₯ β‘οΈ π€πΌ π π π π π’ π₯ π€ π« π©π½βπ» π§π»βπ» π βοΈ π π£ π π‘π π ππΌ |
Linked Templates are an advanced type of Smart Checklist templates designed to create and sustain a dynamic link with related issues when imported. Unlike the regular (non-linked) templatesΒ that involve adding a snapshot of the template during import into the checklist, Linked Templates directly import the live template instance.
Β
Main Highlights:
π Live Connection: Linked Templates stay connected to associated issues, ensuring instant updates and synchronization.
π Immutability: Users can't make changes to the imported Linked Templates, other than changing the status of items.
π Synchronized updates: Admins can update the original template, automatically reflecting changes across all checklists where the template is imported to.
Β
You can create a Linked Template by:
creating a new template from the Templates list on the Jira Issue view or Project Settings
converting the existing template into a Linked Template
π« Don’t hesitate to get in touch with us for any questions or feature requests!