Connect OKRs to roadmaps in workflows with the Objectives app in airfocus

Written by:  Morgan T
Last updated:  

Manage your objectives and key results (OKRs) directly in airfocus and connect them to your roadmaps and workflows to align daily execution with high-level strategy.

Watch: Objectives app

Benefits

  • Connect strategy to execution: Link operational items—such as initiatives, epics, or tasks—directly to key results, ensuring daily product work drives overarching goals.
  • Track progress end-to-end: Gain visibility across all levels of product artifacts, from individual user stories up to long-term company objectives.
  • Real-time visibility with check-ins: Submit regular check-ins to track progress and confidence, enabling teams to spot at-risk objectives early and adjust accordingly.
  • Build organizational transparency: Make OKRs widely accessible across teams to help individual contributors understand how their work fit into company success.
  • Flexible configuration: Customize objective hierarchies, time periods, views, and custom fields to match any goal-tracking process or framework.

Permissions

Permissions work the same as normal workspaces, but for some actions, a minimum role and permission are required.

Action Minimum required role Minimum permission on objective workspace Minimum permission on other workspace
Install or remove Objectives app Admin - -
Manage objective app settings Admin - -
Create a parent/child objective workspace Admin - -
Delete objective workspace Editor Full -
Create an objective Editor Write -
Link or remove product workspaces to objective workspace Editor Full Full
Create key result (on objective) Editor Write -
Link or remove a key result from item side Editor Write Write
View objective workspace Contributor Read only -
View key results Contributor Read only here Or here

Set up the Objectives app

Install the app

To create your first team’s objective workspace, follow these steps:

  1. Click Install the app from the Objectives workspaces section in the left navigation sidebar.
  2. Click Continue.
  3. Adjust the Objectives settings and click Continue.
  4. You can customize the time period by defining a label, start date, and end date, or use the predefined ones.
  5. Click Next.
  6. You can customize the confidence levels by defining the threshold rules that determine progress colors (e.g., On track, At risk, Off track).
  7. Click Finish setup.

Time periods

Time periods define the date ranges used to track your objectives and key results. Each period includes a customizable label, start date, and end date. You can set up custom time periods during the initial app setup or manage them at any time in the Objectives workspace settings.

Confidence levels

Confidence is a visual badge reflecting the probability of achievement of an objective or a key result. You can adjust the confidence level to reflect how much the actual progress of the objective or key result differs from the expected level at a given date of the time period. You can customize threshold rules during the initial app setup or manage them at any time in the Objectives workspace settings.

Objective workspaces

Objective workspaces are displayed in a dedicated section in the navigation sidebar where you can manage objective workspaces and hierarchies:

  • Structure goals hierarchically to reflect complex organizational OKRs: Click on the plus button to create child workspace(s) after setting up your team’s objectives workspace.
  • Link operational workspaces: Select the product workspaces that contain the items you want to connect to key results.
  • Cascade permissions: Enable permission cascading in workspace settings to automatically pass parent workspace permissions down to child workspaces.

Note: Only admins and workspace editors with full permissions can configure global settings and create primary objective workspaces.

Use the Objectives app

Work with objectives

Objectives are a type of item that can only be managed inside of objectives workspaces. Each objective item includes an app card displaying:

  • Progress: Current progress (normalized percentage and actual value).
  • Confidence level: Visual badge reflecting probability of target achievement.
  • Progress graph: Visual timeline showing progress over the time period, with dots marking check-in entries.

Adjust objectives progress calculation modes

To change a calculation mode for an objective item, follow these steps:

  1. Click on your objective item.
  2. Click the three-dot menu in the top-right corner of the progress graph.
  3. Click Change progress mode. You can select one of the following options:
    1. Aggregation (Default): Automatically calculates progress by taking the average normalized progress of all linked key results and sub-objectives.
    2. Manual: Define custom start and target values using Percent, Numeric, or Currency units. Progress updates solely via member check-ins.
    3. None: Disables progress tracking for the objective.

Work with key results

Key results define measurable targets for an objective and can link directly to operational work items across linked workspaces to track their progress.

Link product items to key results by following these steps:

  1. Open your objective item.
  2. Click on your key result.
  3. Go to the Linked items section.
  4. Search and select items from your linked product workspaces to connect execution tasks to the goal.

Adjust key results progress calculation modes

To change a calculation mode for a key result item, follow these steps:

  1. Open your objective item.
  2. Click on your key result.
  3. Click the three-dot menu in the top-right corner of the progress graph.
  4. Click Change progress mode. You can select one of the following options:
    • Aggregation: Calculates progress based on the percentage of linked items moved to a "Closed" status category.
    • Manual: Set a custom start and target range (Percent, Numeric, or Currency) updated via manual check-ins.

Perform a manual check-in

Check-ins record progress updates and qualitative context of an objective and a key result over time.

  • The aggregation mode updates the progress of an objective or key result by calculating total progress from changes in connected sub-entities and adjusts the confidence level based on the Objectives app settings. Users can submit a manual check-in to provide context or make adjustments, which will override the automatic update until the next automatic check-in occurs.
  • When the progress is based on manual updates in a start and target value range, check-ins are the way to make an update to the progress. The latest check-in defines the overall progress.

To perform a manual check-in, follow these steps:

  1. Open an objective or key result item.
  2. Click + Check-in on the right side of the item panel.
  3. Enter current progress values (if Manual mode has been set up).
  4. Select or adjust the confidence level.
    • On track.
    • At risk.
    • Off track.
  5. (Optional) Add a comment to provide context.
  6. Click Save.

View objectives

Filter options

The Objectives app adds a couple of filters to the objective workspaces and regular workspaces.

To use the Objectives filter on an objective workspace, follow these steps:

  1. Click Filter.
  2. Next to “Where”, you can select the following fields and conditions:
    1. Confidence.
      1. Contains any.
      2. Does not contain any.
    2. Key results.
      1. Is defined.
      2. Is undefined.
    3. Progress.
      1. Is.
      2. Is not.
      3. Is greater than.
      4. Is greater than or equal to.
      5. Is smaller than.
      6. Is smaller than or equal to.
    4. Time period.
      1. Contains any.
      2. Does not contain any.
      3. Starts before.
      4. Starts before or on.
      5. Starts after.
      6. Starts after or on.
      7. Ends before.
      8. Ends before or on.
      9. Ends after.
      10. Ends after or on.

On a product workspace, Key result field will become available in the filter.

Group options

On an objective workspace, you can group by Confidence and Time period.

On a product workspace, you can group by Objectives and Key results.

Give feedback on this article

Have feedback about this article? Tell us about your experience here.

Did you find what you were looking for?

Still have a question or want to share what you have learned? Visit our Community to get help and collaborate with others.