Skip to main content
OKRs Migration Guidelines
Maayan Ayalon avatar
Written by Maayan Ayalon
Updated over 6 months ago


As Craft.io embraces a new and improved OKRs solution, we are committed to keeping your OKRs data intact during this transition.

*Don’t worry, all your data is safe*

We are introducing a new model structure that establishes a hierarchical relationship between Objectives and Key Results, enhancing the way you manage and visualize your goals.


Below is a list of areas to be mindful of, after the migration takes place.

  1. To support a parent-child relationship and data enrichment, OKRs will be moved out of the Strategic Inputs view and into a designated OKRs Table view.


  2. As we transition to an improved data structure, the OKRs folder’s description will be converted into work items, according to their terminology. This change aligns with the new hierarchical structure.


  3. To ensure a more structured and effective OKR system, we are implementing a strict hierarchical structure where each Key Result must be linked to a parent Objective. As part of this transition, existing Key Results will be initially nested under a placeholder parent named ‘Untitled Objective’ by default. You will need to reassign these Key Results to their correct Objectives to maintain accuracy and alignment.


  4. In light of our new hierarchical structure, working items that have a Key Result associated with them will be temporarily assigned to an ‘Untitled Objective’. Once the parent Objective is adjusted, this placeholder assignment will be removed.


  5. Until now, Objectives could span across multiple Quarters/Releases due to the lack of a strict structure. However, as we transition to our updated OKRs model, each OKR will be assigned to a single Quarter/Release. To maintain your roadmaps and views, Objectives and Key Results assigned to multiple quarters will be duplicated for each assigned Quarter/Release. This change ensures that moving forward, each OKR will be associated with only one Quarter/Release, and each Key Result will have a single parent Objective.



    Should any questions arise, we are here to help!
    Reach out to us at Support@craft.io.

Did this answer your question?