How to use Snippets for Jira

Opening the app

After installation the app will become available at the following locations:

Issue Glance

1. Navigate to one of your Jira projects and open an existing Jira Issue

2. On the right side of your screen, inside the Details panel, click Open Snippets for Jira

The apps issue glance view allows you to create & use snippets directly in your Jira Issues

Snippet manager

1. Navigate to the Apps menu in your top navigate bar

2. Click on Snippet Manager

The Snippet manager page allows you to manage all snippet folders & snippets within your Jira instance.

Creating Snippets

Issue Glance

1. After opening the app in the issue glance click on Add Snippet
   Upon clicking on Add Snippet the New Snippet dialog will open

2. Select the folder you would like to add a snippet to
   If this is the first time you are creating a snippet please make sure to create a folder first. This can be done within the context of the New Snippet dialog by clicking on <create new private/shared folder> in the folder select dropdown or by navigating the the snippet manager page.

3. Fill in a title for your Snippet
   We recommend giving your Snippets unique names as this makes it easier to find them when needed

4. Add your Snippet text
   You can use Jira smart values in your snippet to dynamically add contextual information

5. Click Add snippet

6. Your snippet is now added and ready to be used 🎉

To create more snippets, click the Add Snippet button in the top right side of the application.

Snippet Manager

1. After opening the Snippet Manager page, select the folder you would like to add a snippet to
   If this is the first time you are creating a snippet please make sure to create a folder first. This can be done within the context of the Snippet Manager page by clicking Create folder.

2. Click on Add Snippet
   Upon clicking on Add Snippet the New Snippet dialog will open

3. Fill in a title for your Snippet
   We recommend giving your Snippets unique names as this makes it easier to find them when needed

4. Add your Snippet text
   You can use Jira smart values in your snippet to dynamically add contextual information

5. Click Add snippet

6. Your snippet is now added and ready to be used 🎉

To create more snippets, click the Add Snippet button in the top right side of the application.

Using Snippets

Using snippets works the same in the issue glance view & in the snippet manager.

1. To copy text from a Snippet, simply click on the snippet itself or click on the button

2. To edit a Snippet, click on Edit snippet in the triple dot menu

3. To delete a Snippet, click on Delete snippet in the triple dot menu

4. To duplicate a Snippet, click on Duplicate snippet in the triple dot menu
   In the Duplicate snippet dialog you can select in which folder you would like to create the duplicate

Folders

To keep your snippets organised, snippets can only exist within the context of a folder. The app provides you with two folder types.

Private folders
Private folders are only available to you, the snippets within this folder can only be edited or deleted by you.

Shared folders
Shared folders allow you to share snippets with all users within your instance. For these folders & the snippets within these folders, the following permissions apply:

Folders

*User without additional permission

Snippets

*Duplicate can only be added to private folder