Understand Craft.io’s data model

Welcome to Craft.io! Before you get started, here’s a quick overview of our data model and the main terminology used throughout the platform.

Craft.io’s system of record allows you to clearly organize and manage both your product strategy and product planning stages. The Craft.io data model is comprised of the following components:

Workspace > Product > Sections > Features > Sub-features (optional)

Alongside these components are the time-bound containers of Sprints and Releases, which define specific timelines for development and deployment.

downloads.intercomcdn.comio1874962108e7cf21c2ca28cfd3c987ec2Data+White+BG@1xcrop

Your Workspace is the hub for all your product management work in Craft.io. Typically one Workspace will suffice for a large business–it’s where you will plan, collaborate, and finally sync with your product development software. Utilize additional Workspaces only when you need to define different team structures or unique terminology and where there is no need for joint Feature prioritization or dependency planning between multiple Workspaces.

Products are high-level entities that help you to organize your work (e.g. Analytics). Later, you can divide your Product into smaller, more manageable Sections, Features, and Sub-Features.

Sections are the main components that appear below your Product layer and allow you to cluster and organize groups of Features. An example of a Section could be Filter Enhancements. These larger and over-arching Sections eventually get mapped into your preferred development tool as epics.

Features are the building blocks that sit below Sections. They represent a user need or specific set of requirements that you need to build, e.g. Create a new filter button or Enable multi-select of menu items. A well-written Feature provides all stakeholders with the necessary requirements and material to refer to during development. Once a solution is defined for a Feature in terms of development efforts, you can push the Feature into your preferred integrated dev tool as a user story. 

Sub-features are an optional additional layer can be used by those who want to further break down their Features into smaller tasks and to-dos. 

Releases are the deployment date or time period you attach to your Features, typically spanning many weeks and which allow you to manage multi-feature release cycles. These can be named as numbered/descriptive releases, quarters, etc. (e.g., “MVP” or “Release 3.1” or “Q1”).

Sprints are lower level, short, time-boxed containers where the focus is on the delivery of smaller Features or Sub-features. 


To sum up:

Term

Definition

Development tool mapping

Workspace

A collaborative space for planning and management of Products.

A single workspace typically houses multiple Product teams. One workspace will suffice in the vast majority of Product Management use cases.

Not applicable.

Product

High-level entities that help you to organize your work.

In most cases, this represents a Product team or large aspect of your customer-facing proposition.

Typically corresponds to a project or specific integration instance but is not a required mapping.

Can be mapped to your integrations as a ‘Label’ so you have visibility of where the item resides in Craft.io. 

Section

Allow you to cluster and organize groups of Features.

Contain time, effort and prioritization metadata. 

Typically map to epics or equivalent.

Feature

Represent a specific user need or a product capability you plan to build. 

Contains time, effort and prioritization metadata. 

Typically map to user-stories or equivalent.

Sub-Feature

Optional. Can be used to further break down Features into smaller tasks and to-dos. 

By default, Sub-Features do not map into dev tools, however, this can be customized if desired.

Release

Deployment date/time period attached to Features. Can be defined as per your organization’s terminology (e.g. MVP, Quarters, etc.)

Optional. Typically map to Fix Versions or equivalent.

Sprint

Shorter work cycles where the focus is on the delivery of smaller Features or Sub-features. 

Automatically map to Sprints in Jira.