App Home Screen and Settings

Your home screen in Slack acts as a dashboard for Jira inside Slack. You can access your home screen as an easy way to interact with Jira from Slack.

What to know:

• You can view lists of issues, create new issues and update existing issues from your home screen.
• You can set preferences and settings to control your home tab configurations.
• You can update settings via the Settings button in the bottom right.

Navigating to the home screen in Slack

Adding the app

1. Navigate to the Apps section in Slack
2. Click the + button
3. Type jira and select Jira Integration+

Accessing the app

1. Navigate to the Apps section in Slack
2. Click on Jira Integration+

Using the home screen

Learn how to use the home screen and greatly reduce the need to switch context between Slack and Jira.

Viewing issues assigned to you (default)

1. Navigate to the Jira Integration+ app in Slack
2. View the list of assigned issues (or your configured default - see below)
3. Optional: Expand or collapse issue information and quick actions
   1. Click the checkbox expand issue information to view additional issue information
   2. Click the checkbox show quick actions to access quick issue actions.

Changing the list of issues on the home screen

1. Navigate to the Jira Integration+ app in Slack
2. Click the Change button in the upper right
3. Choose from one of the default filters or use a JQL query to find a list of issues.
   1. Issues assigned to me (default) - view the issues that are assigned to you.
   2. Watched issues - issues you are watching
   3. Recently created in a Project(s) - find issues that have been created recently in one or more projects
   4. Specific status(es) by project(s) - find issues in one or more projects that are in a specific status or set of statuses
   5. Current sprint by project and status(s) - view issues in the current sprint for a specific project
   6. Custom JQL - enter your own JQL query to find a list of issues - see more here.
4. View the selected list of issues on the home screen.

Viewing a list of issues using JQL

1. Navigate to the Jira Integration+ app in Slack
2. Click the Change button in the upper right
3. Scroll down to the option Custom JQL Query
4. Enter your JQL (learn more about JQL here)
5. Click the Save button

Create New Issues

Creating issues from the home screen is the easiest way to create new issues in Jira without switching context.

1. Navigate to the Jira Integration+ app in Slack
2. Click the Create button
3. Fill out the form and click the Next button to create your issue.You can set your project and issue type in your personal settings.

Set your Quick Create defaults

The quick create settings allow you to set a default project and issue type when you create issues. This configuration will be utilized everywhere in Slack as your personal default.

1. Click the Settings button on the home tab
2. Choose a Jira project to be your default.
3. Select the issue type for your default.
4. Click the Save button to save settings.

Find and share issues

Finding issues in Jira and sharing with your team in Slack is a great way to prevent context switches. Use the home screen to make this process simple from Slack.

1. Navigate to the Jira Integration+ app in Slack
2. Click the Find Issue button
3. Enter your search term (the app searches in the issue name, key and description)
4. Select the issue that you were looking for
5. Share the issue with a channel or user in Slack.

Assign Issues and bulk assign

You can find issues in Jira and assign them easily from your home screen. You can also assign multiple issues!

1. Navigate to the Jira Integration+ app in Slack
2. Click the Assign button
3. Enter your search term (the app searches in the issue name, key and description)
4. Choose one or more issues
5. Choose the user you would like to assign the issues to.

Add a comment

1. Navigate to the Jira Integration+ app in Slack
2. Click the Comment button
3. Enter your search term (the app searches in the issue name, key and description)
4. Choose an issue
5. Enter your comment on the issue
6. Click the Add comment button