Features

Roadmap

Publish product roadmap items from Notion-backed content.

Update your roadmap in real-time to keep your users aware of your progress

We offer you the ability to keep your users aware of your progress with a smooth roadmap process using notion.

Setup

See the notion documentation to setup your roadmap. Same way as implementing a blog with notion.

But instead you gonna use this notion database template :

Roadmap Template

We recommend you to use our template to make it work with the already existing ui. But you can customize it to your needs.

Instead of setting the NOTION_POSTS_DB_ID, you gonna set the NOTION_ROADMAP_DB_ID.

Content type definition requirements

Required fields

Here is the list of the required fields for a content type definition:

title: title
status: status

Contrary to the other notion content type definitions, you do not need to have a slug field.

Config file

Your config file should look like this:

config/cms.config.ts


'server-only';
 
import { parseNotionConfig } from '@kit/notion/config';
import { envs } from '~/envs';
 
export const notionConfig = parseNotionConfig({
    auth: envs().NOTION_INTEGRATION_SECRET,
    contentTypes: {
        posts: {
            id: envs().NOTION_POSTS_DB_ID,
            def: {
                categories: 'multi_select',
                language: 'select',
                description: 'rich_text',
                slug: 'rich_text',
                image: 'files',
                status: 'status',
                title: 'title',
            },
        },
        roadmap: {
            id: envs().NOTION_ROADMAP_DB_ID,
            def: {
                status: 'status',
                tags: 'multi_select',
                priority: 'select',
                deadline: 'date',
                title: 'title',
            },
        },
    },
});

MCP Context

capability: roadmap_content
entrypoints:
  - @kit/notion/config
inputs:
  - roadmap_database_id
  - roadmap_property_mapping
outputs:
  - roadmap_content_feed
constraints:
  - roadmap mapping must include title + status
side_effects:
  - Notion API reads

Agent Recipe

Add roadmap content type in notion config.
Ensure env var for roadmap DB ID exists.
Render roadmap page using Notion content client/query layer.

Troubleshooting

Schema parse errors usually indicate missing status mapping.
Empty roadmap means integration lacks access to the target Notion database.

Notion

Table of Contents

TOC components for structured long-form content navigation.

Documentation

How this docs website is structured and how to adapt it for customers.

How is this guide?

Last updated on 3/23/2026