Skip to main content
Skip table of contents

Getting started

You're just a few steps away from using all the great features of Microsoft 365 for Jira for you and your team. Enable your favourite features and find out which Microsoft integration works best for you.

Our application requires both Jira and Microsoft administrators to take action at some point in the setup process. We recommend that you involve both administrators from the beginning to ensure a seamless implementation of Microsoft 365 for Jira in your organisation or team.

Admin Responsibilities

 

Responsibility

To Do

Step 1

JIRA ADMIN

Installs Microsoft 365 for Jira
via the Atlassian Marketplace

Step 2a

JIRA ADMIN

Activates features globally or for specific projects
via the admin settings in Jira

Step 2b

JIRA ADMIN

Configures features for all or specific projects
via the admin settings in Jira

Step 3

JIRA ADMIN

Check and configure connection settings
via the connection settings page in Jira

Step 4a

MICROSOFT TEAMS ADMIN

Email feature:
Deploys Outlook add-in

Step 4b

MICROSOFT TEAMS ADMIN

Teams feature (Jira):
Installs Teams app

Teams feature
(JSM only):
Installs Teams portal app

Step 5

MICROSOFT TEAMS ADMIN and MICROSOFT ADMIN

Approves Microsoft 365 access

Set-up

Step 1: Install the app

JIRA ADMIN
Install Microsoft 365 from the Atlassian Marketplace. If you need further assistance, follow the instructions here.

image-20250530-074007.png

Step 2a: Getting started

JIRA ADMIN
Microsoft 365 for Jira offers a range of features, not all of which may be relevant to every Jira project.

Our app gives you the flexibility to decide which features are available to your team, and whether they appear in all Jira projects or only in specific ones. Click “activate” to manage their visibility.

However, to get to know the features first, scroll down to learn more about the features via dedicated videos.

image-20250603-165833.png

Step 2b: Activate & configure features

JIRA ADMIN
Right after the installation, our app’s features can be already activated for all or only specific projects in the getting started section. However, configuration settings might need to be changed or adapted due to project requirements.

In the activate features section, features can either be set as a default for all Jira projects or can be individually toggled on / off on a project specific basis.

image-20250603-181022.png

Step 3: Connection settings

All apps deeply integrate with Microsoft 365, which is a cloud only solution. That’s why our Microsoft 365 for Jira app behaves differently than “classic” Data Center apps.

Learn more on the detailed instructions for seamlessly installing our app on your instance, along with the necessary requirements to ensure optimal performance.

Step 4a: Outlook add-in

MICROSOFT ADMIN

When activating the Email feature, you’ll need to install the free Outlook add-in to connect Jira and your Outlook inbox. Our app will guide you through the process.

image-20250603-170815.png

Only by installing the free Outlook add-in will you be able to access Jira features from your Outlook inbox to e.g. bring emails to Jira and work with Jira issues in your Outlook inbox.

If you enable the email feature, but don't install the Outlook add-in (as recommended), you can only access Outlook features in Jira and e.g. see related emails in your Jira issue.

Step 4b: Microsoft Teams app

MS TEAMS TEAM OWNER MS TEAMS ADMIN MICROSOFT ADMIN

When activating the Teams feature, you'll need to install the free Microsoft Teams - Smart Connect app to connect Jira and Microsoft Teams. Our app will guide you through the process.

image-20250603-171011.png

Only by installing the free Microsoft Teams - Smart Connect app you can access Jira features in MS Teams to e.g. share Jira issues with your team or create new issues based on chats or channel conversations.

If you activate the Teams feature, but don’t install the Microsoft Teams - Smart Connect app (as recommended), you can only start MS Teams chats from your Jira issue.

Integrate JSM portal in MS Teams

JIRA ADMIN MS TEAMS ADMIN USER

image-20250603-171113.png

After installing the Microsoft Teams - Smart Connect app (see above), we recommend to also install your JSM portal in Teams to allow customers to conveniently raise support tickets directly from Teams. They can follow up on their ticket status in a separate tab, too!

Step 5: Approve Microsoft 365 access

MICROSOFT ADMIN

We recommend that you approve Microsoft 365 access rights (centrally) during the setup process. Otherwise, you may need to approve access the first time one of your users interacts with any of the features.

Microsoft 365 for Jira requires specific access permissions to function properly and to reach its full potential. Failure to do so may result in features not working as intended.

image-20241023-083842.png

Microsoft Azure

Go to your MS Entra admin center:

  • Open your applications.

  • Search for our apps.

  • Go to “Permissions” and

  • Grant admin consent” centrally.

image-20240711-094711.png

Permission screen

Approve Microsoft 365 access in order to use our features.

Learn more about Microsoft 365 permissions for yasoon’s app.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.