This guide will walk you through the initial setup performed by your Plugin Administrator.
1. App Installation
To install the app:
Open our page in Atlassian Marketplace
Select a version: Cloud or Data Center
Install the app and start a 1-month free trial
2. Plugin admins
Once the plugin is installed, all Jira Admins will become Plugin Admins automatically.
In case you need to grant such permissions to other users, please:
Open Plugin Settings
Users & Admins
Administrators
Hit “+ Add Administrator” and search through a list of users already added to the plugin
3. Intervals
Intervals are OKR cycles in which you set, execute, and monitor your goals in a particular timeframe.
Intervals are fully customizable and can always to adjusted to your needs. To create an interval:
Click the interval box on the top left part
Click “Manage Intervals“ and click “New Interval“
Give your interval a Title
Pick a Time Period and start/end dates
Click “Confirm”
4. OKR Levels
OKR Levels allow you to create a custom hierarchy for your objectives based on your company structure.
We create a basic setup: Company, Group, and Personal levels of objectives, but you can rename or delete them if you wish. To adjust your levels:
Navigate to Settings > OKR Levels tab
Click "+ Create OKR Level”
Fill up the name, ID and pick the color of the icon
Done
5. Global plugin access
Global permissions define which Jira users can see the button to enter the plugin and the OKR section on the Jira Issue form. Users without access cannot see the plugin in the navigation bar.
This article will guide you on how to grant your Jira groups access to the plugin: Global Plugin Access
6. Groups
Groups can represent your departments, teams, or any other structure present in your organization.
Additionally, you can sync your existing Jira groups with Plugin groups so all newly added users are automatically synced with your in-app group. To create a group:
Open your workspace settings
Click “Create a group”
Once a group is created, you can add individual users to it
Or sync with existing Jira group
7. Users and Roles management
The Users & Admins settings page will allow you to add individual users and select which workspaces they will have access to, add them to groups, and define their roles in the plugin.
There are several roles that can be assigned to your users: Reader, User/No delete, User, Group Leader, Workspace admin, and Plugin Admin.
More detailed information on roles & permissions can be found here: User roles and permissions
To add a user:
Open the “Users & admins” page in Settings
Click “Add User”
Select a User. Choose Workspaces, Groups, and Roles
Hit “Add”
8. Confluence app
OKR Board for Confluence macros allows you to embed OKRs into Confluence pages. Using macros helps you to extend the capabilities of your Confluence pages, allowing you to add extra functionality or include dynamic content.
These articles will guide you through the installation process:
OKR Board for Confluence macro (Cloud)
OKR Board for Confluence macro (Data Center/Server)
For all the already existing OKRs, we will apply the following values:
For OKRs that were not updated since the creation, the Last Grade update will be based on the creation date
For OKRs that were updated, the Last Grade update will be based on the last auto or manual grade change
0 Comments