DEV Community

JustOneCX
JustOneCX

Posted on Originally published at justonecx.com

How to build a public product roadmap

A public product roadmap is a page where customers see what you plan to build, what you are building and what you shipped. To build one, collect ideas from customers, let them vote, move each idea through three statuses (planned, in progress, shipped) and publish the result where customers already look. In JustOneCX this is one setup in the Roadmap & Changelog module, shown in three ways.

What does a public roadmap contain?

A roadmap is made of three parts. Each one answers a different customer question.

Part What visitors see
Roadmap Ideas grouped by status: planned, in progress, shipped.
Ideas Ideas with votes and comments. Visitors can submit new ones.
Changelog The entries you published, newest first. Visitors can mark an entry helpful.

The roadmap tells people where an idea stands. The ideas board is where they ask for things and show how much they care. The changelog is the record of what you shipped. You manage all three in the dashboard under Roadmap & Changelog.

How do ideas and votes work?

An idea is a request. A customer submits one, or you add one yourself. Other visitors vote on it and comment. Votes are a signal, not a promise. They help you see which requests many people share.

When you open an idea, you can see who voted and which account they belong to. You can sort the idea list by identified people or by accounts, so you can build for your customers first. Visitors never see this. Public pages show no emails and no full names.

What do the statuses mean?

Every idea moves through the same three statuses.

  1. Planned. You intend to build it. It is not started.
  2. In progress. Someone is working on it now.
  3. Shipped. Customers can use it.

When you mark an idea Shipped, two things happen. Its voters get an email, and a changelog draft is created for the idea. You edit the draft in the Changelog tab and publish it. Nothing reaches the changelog until you publish it. Read how to write a changelog for what a good entry looks like.

When you change an idea's status or reply as the team, voters and commenters with an address get an email from your workspace name. Every email has a one-click unsubscribe link.

What are the three ways to show the roadmap?

You set up the content once. Then you turn each way on or off in the Publish tab. All of them show the same content.

  1. On your website. Embed the roadmap, ideas and changelog in any page. You can also add an in-app What's new panel. See the embed guide and the What's new widget.
  2. On your own subdomain. Serve the pages from a hostname such as roadmap.yourcompany.com. See roadmap custom domain.
  3. On the hosted page. Every workspace gets a page at boards.justonecx.com/<workspace-slug>/roadmap. There is nothing to install.

The embed code for plain HTML is three elements, after the SDK script:

<script src="https://app.justonecx.com/sdk/justonecx-sdk.global.js"
        data-public-key="pk_your_workspace_key"
        data-api-url="https://api.justonecx.com"></script>

<justonecx-roadmap></justonecx-roadmap>
<justonecx-ideas></justonecx-ideas>
<justonecx-changelog></justonecx-changelog>
Enter fullscreen mode Exit fullscreen mode

The dashboard generates the exact code for your framework, with your key filled in.

Hosted pages are rendered on the server, so search engines and link previews see the real content. Each idea and changelog entry has its own link. Public boards can be indexed. Identified and private boards send noindex.

Who can see and act on the roadmap?

Pick an access mode in Roadmap & Changelog > Publish.

Mode Effect
Public Anyone can read. Writing (vote, comment, submit) needs no sign-in.
Identified Anyone can read. Writing needs a visitor you identified.
Private Only customers you signed in with a verified identity can read.

Use Public if you want the widest reach. Use Identified if you want every vote tied to a known customer. Use Private if the roadmap is for customers only. On a hosted page or a custom domain, a sign-on link tells the page who the visitor is.

How do you moderate ideas and comments?

New ideas and comments can wait for approval. Only approved content is public. Turn this on in Publish, then review items in Roadmap & Changelog > Moderation.

Moderation is useful when the board is fully public. It keeps spam and off-topic posts away from your customers. You can also merge a duplicate idea into another one, so votes stay together.

What is a good way to run the roadmap day to day?

Keep the routine small.

  • Check the moderation queue when you review support requests.
  • Move an idea to Planned only when you mean it.
  • Reply to ideas you will not build. A short honest answer is better than silence.
  • Mark ideas Shipped when customers can use them, then publish the changelog draft.

You can also do this work with an AI assistant connected through the MCP server. It can list ideas, edit them and read the moderation queue. A status change that emails voters needs an explicit confirm. The access levels are in the MCP server docs.

Frequently asked questions

Do I need to write code to publish a roadmap?

The hosted page has nothing to install. It exists for every workspace at boards.justonecx.com/<workspace-slug>/roadmap. You turn it on in the Publish tab. Embedding on your own site takes a script tag and one element.

Can a roadmap be private?

Yes. Set the access mode to Private. Only customers you signed in with a verified identity can read it.

Does publishing an announcement add a changelog entry?

No. Announcements you publish in your product do not add changelog entries. Entries come from the Changelog tab, or from the draft created when you mark an idea Shipped.

Which plans include hosted pages and embeds?

Hosted pages, embeds and custom domains are in every plan. A custom domain stops serving if your plan drops below Scale. The hosted address keeps working.

See how it works in the live demo.

Top comments (0)