Managing the company roadmap

Last updated:

|Edit this page

Creating a new roadmap item

  • Log in to Strapi
  • Click Roadmap in the sidebar
  • Click New

Roadmap fields


The title of the roadmap item. Self-explanatory.


A brief description of what the roadmap item intends to accomplish.

Projected completion date / Date completed

The projected completion/completion date of the roadmap item. If the “Complete” checkbox is checked, this field label will change from “Projected completion date” to “Date completed”.

This field also controls where the roadmap item appears on the roadmap page.

  • If no date is present, it will appear under “Under consideration”.
  • If a projected completion date exists, it will appear under “In progress”.
  • If a completed date is added, it will appear under “Recently shipped”


Used to group roadmap items together. We only use this field to categorize the milestones on the homepage.

Add GitHub URL

If a GitHub issue is relevant to the roadmap item, you can paste the entire URL here. There is no limit on how many issues you can attach.

This field is used to display GitHub issue titles and links on roadmap items under the “Under consideration” section. It also determines the progress of the roadmap items under the “In progress” section.


Used to show album art for roadmap items under the “In progress” section. Images should be square, at least 200 x 200 pixels, and not contain any borders or shadows. Images are optional. If you need a new image, [request it through the normal process](/handbook/design/about-design#blog-artwork-and-marketing-assets.


Used to determine if the roadmap item is complete. If checked, the date field will change from “Projected completion date” to “Date completed”.


If checked, the roadmap item will appear on the roadmap section of the homepage.

Beta available

If checked, buttons under the “In progress” section change from “Subscribe for updates” to “Get early access”.

Notify subscribers

Only appears when editing an existing roadmap item. See here for more info on how to use this feature.

Notifying roadmap subscribers

  • Log in to Strapi
  • Click Roadmap in the sidebar
  • Click Edit on a roadmap item
  • Make the necessary changes to the roadmap item
  • Check the “Notify subscribers” checkbox
  • Click “Next”

You’ll see a couple of new fields.


The subject of the notification email.


The body of the notification email. Supports Markdown.

This field will auto-populate with any changes you’ve made to the roadmap item. For instance, if you check the “Beta available” field before clicking “Next”, the content will be auto-populated with “Beta is now available”.

View subscribers

Click this button to see all subscribers who will receive the email.

Once your email body and subject are ready, click “Update & notify subscribers” to add the emails to the email queue. Any emails sent from Squeak are automatically placed in “Draft”.

To send the emails, you must log in to > Click “Broadcasts” > Click “API Triggered Broadcasts” > Click “Squeak! Roadmap item” > Click “Drafts”. From here, you can select and manually send all roadmap notification emails.

Note: This will change in the future. Once we determine this works as intended, we can automatically send emails directly from Squeak and cut out the steps.


Was this page useful?

Next article

Editing the API docs

The PostHog API docs are generated using drf-spectacular . It looks at the Django models and djangorestframework serializers. Note: We don't automatically add new API endpoints to the sidebar. You need to add those to src/navs/index.js You can add a help_text="Field that does x" attribute to any Model or Serializer field to help users understand what a specific field is used for: To add a description to the top of a page, add a comment to the viewset class: To check what any changes…

Read next article