FAQ

Frequently asked questions

Answers to the questions we hear most. Still stuck? Use the feedback button — we read everything.

Getting started

  • What is Roadmark, and how is it different from Notion or a Gantt chart?

    Roadmark is a roadmap tool built around the one thing static docs never capture: how and why your plan changed. You fork your roadmap at any milestone like a git branch — the path you took and the one you abandoned both stay on the canvas, each pivot carrying a required decision log. No doc, spreadsheet, or Gantt chart gives you that history.

  • Do I need to install anything?

    No. Roadmark runs in your browser — sign up and you’re on a board in under a minute. There’s nothing to download.

  • How do I sign in — can I use GitHub or Google?

    Your choice: an email and password, or one click with GitHub or Google. Signing in with a provider only shares your name and email — it does not give Roadmark access to your repositories, or anything else in that account. (Connecting a tool to import a roadmap is a separate, explicit step with its own read-only permission.) Use the same email across methods and it stays one account — no duplicates — and you can add a password to a GitHub/Google account any time from your settings.

  • Is it really free?

    The Free plan is genuinely free, for good: create up to three roadmaps, import from any supported tool, share public read-only links with anyone, draft milestones with your own AI key, and export to PNG, SVG and PDF. Inviting named collaborators onto a board, posting comments on milestones, and capturing roadmap releases are paid features (Pro/Team) — on a Free board you can still read the discussion and any releases, and public link sharing always stays free. Sign up free and your first 14 days also include full Pro (no card); when the trial ends you move to Free with all your roadmaps kept — you just can’t add more until you upgrade. Paid plans are launching soon; see the pricing page for what each includes.

Privacy & your data

  • Who can see my boards?

    Private by default — only you and the people you explicitly invite (as owner, editor, or viewer). A board becomes visible to anyone else only if you flip it public, and even then it’s strictly read-only.

  • If I share a board publicly, do you track who views it?

    On the Team plan you get a Views panel for each board: how many times your public link was opened, unique vs returning visitors, time spent, and where visits came from (referring site, device type, country). It’s deliberately coarse and anonymous — we don’t store IP addresses, names, or emails, and your own visits aren’t counted. We keep a single random, non-identifying id in the visitor’s browser to tell unique from returning, and we record nothing at all if their browser signals “Do Not Track” or they decline the cookie notice shown on public board pages. Like the Activity log, the Views panel is a Team feature and is visible to the board’s owner only.

  • Do you sell my data or use it to train AI?

    No. We don’t sell your data and we don’t train any model on it. AI generation only sends the prompt you choose to generate, and only to the provider whose key you supplied.

  • Can I export or delete everything?

    Yes, on both counts. You can download your account data and permanently delete your account and its boards yourself from settings — no support ticket required. Any single board can also be downloaded as a PNG, SVG or PDF — or copied to your clipboard as an image to paste straight into Slack, Notion or an email — from the export menu under the zoom controls.

  • Are my keys and tokens encrypted?

    Yes. Everything sensitive you connect is encrypted at rest with AES-256-GCM and is never logged or stored in plaintext — both your AI provider keys (Anthropic, OpenAI, Google) and the credentials that link your import sources, whether an OAuth token or a personal access token you paste for a self-hosted tool. Once saved, you can replace a key or token but never view it again — only the app reads it, behind the scenes, to reach the provider.

  • Can I change my email or password?

    Yes — both from your account settings. Changing your email sends a confirmation link to the new address before it takes effect (so a typo can’t lock you out); changing your password takes effect right away and emails your account a heads-up.

Building your roadmap

  • How do I add or edit milestones?

    On a board you own or can edit, add a milestone right on the canvas — give it a title, an optional description, a target date, and a status (completed / active / upcoming / skipped). Editing or removing one works the same way, and changes save as you go.

  • Can I rename my board or change its description?

    Yes. Owners and editors can rename the board and rewrite its description any time from the board’s edit view — including on a board you imported. The description is required, so a board always says what it’s for.

  • How do I make a pivot (fork a branch)?

    Pick the milestone where your plan changed and fork a new branch from it. Roadmark asks for a decision log — a short note (at least 20 characters) on why you changed course. It’s required on every branch except the main one, so the reasoning behind a pivot is never lost. The new branch shares the history up to the fork point, then tells its own story.

  • Why won’t it let me add a milestone to a branch — or pick an early date?

    Two guardrails keep the timeline unambiguous. Once a branch has another branch forked off it, that branch is “closed” at the fork — new work goes on the child branch instead, not the parent. And a milestone on a forked branch must be dated on or after the point where it split off, since a pivot can’t contain work that predates the pivot.

  • What happens when I delete a milestone or a branch?

    Deleting a milestone removes just that milestone — unless a branch was forked from it, in which case you delete that branch first (the milestone is its anchor). Deleting a branch permanently removes the branch and every milestone on it; if it has its own child branches, delete those first. The main branch can’t be deleted, and none of this touches the history on other branches.

  • What happens when I delete a board?

    Deleting a board is permanent and immediate — it removes the board, all of its branches and milestones, and every member’s access at once. Only the board’s owner can do it, and it can’t be undone, so make sure before you confirm.

  • Can I capture a version of my roadmap and see what changed?

    Yes — from the board editor’s toolbar, tag the whole board’s state under a label like “Series A — Mar 2026”. That release is frozen and never changes, so later you can compare it against where the roadmap is now and see exactly what shipped, what slipped, and what was added or dropped — the “what we promised vs. where we are” you’d send an investor. You can even hit “Draft investor update” to turn that diff into a short, founder-voiced summary (on your own AI key) — then edit it and email it to your investors right from Roadmark, with a confirm step before it goes. Each recipient gets it privately and replies land in your own inbox, not ours. Capturing releases is part of the paid plans (the board needs an owner on Pro or Team); everyone on the board, viewers included, can read and diff the ones already captured.

  • Is there an audit log of who changed what?

    Yes — on Team, every board has an Activity log: an append-only record of who changed what and when — milestone edits, branch status changes, visibility flips, member invites / role changes / removals, and release captures. You can filter it by type or date and search by name, person, or role. It’s the decision-evidence trail for a data room. The history is recorded for every board all along, so the moment you’re on Team it’s there in full — and it’s visible to the board’s owner only.

Importing a roadmap

  • Which tools can I import from?

    GitHub Projects, GitLab, Linear, Jira, Shortcut, YouTrack, Azure DevOps, and Asana — plus a CSV upload for anything else. One “Import roadmap” button opens a picker of everything you’ve connected.

  • Will importing change anything in my source tool?

    Never. Every import is a one-way, read-only snapshot — we read your project once and build a Roadmark board from it. Your source tool is never written to, and nothing there changes.

  • What exactly gets imported?

    Your milestones: their titles, descriptions, target dates, and a status mapped to Roadmark’s four states. Imports are intentionally flat — branches and forks are a Roadmark-native layer you add on top, so we never invent pivots that weren’t in your source.

  • Does an import stay in sync with the source?

    Yes, if you want it to — your Roadmark edits never flow back to the source, but pulling from the source works two ways. The editor’s toolbar has a Sync button on every imported board (except CSV uploads, which have no live source to ask), and next to it an Auto-sync toggle that pulls the latest once a day on its own, using the connection of whoever switched it on. If that connection later expires, auto-sync turns itself off and the board tells you to reconnect — so it never sits “on” while quietly failing every night.

  • How do I refresh an imported board with newer changes?

    Press Sync in the board editor’s toolbar. It pulls a fresh snapshot from the source and applies only the differences — your work is never overwritten: milestones you edited keep your version, your own milestones and forked branches with their decision logs aren’t touched at all. Items that vanished from the source are removed only if you never touched them; anything you edited or forked from stays and wears a small “removed from source” chip on the canvas instead. After each sync a short summary shows exactly what changed. (And with Auto-sync on, the same refresh runs once a day by itself.)

  • What permissions do you ask for?

    Read-only scopes, nothing more — just enough to list your projects and read their milestones. For self-hosted GitLab, YouTrack, or Azure DevOps you paste a personal access token and your instance URL; nothing is ever written back. (Whichever way you connect, the token is encrypted — see “Are my keys and tokens encrypted?” above.)

  • How are imported statuses decided?

    Every tool models “done” differently, so on import we map each source’s states onto Roadmark’s four: completed, active, upcoming, and skipped.

    One rule then runs across every board at display time: an upcoming milestone whose target date has already passed is shown as active (overdue) — so a plan that slipped never silently looks on-track. A milestone with a completion date always shows completed, and a stored completed or skipped status is always kept.

    • GitHub ProjectsFrom your status field — done / closed / shipped / merged → completed; in progress / active / in review / wip → active; anything else or blank → upcoming. Date from your target / due / iteration field.
    • GitLabProject milestones — closed → completed; open and past its due date → active; otherwise upcoming. Date from the due date.
    • Linear (initiative)Project state — completed → completed; started / paused → active; canceled → skipped; backlog / planned → upcoming. Date from the target date.
    • Linear (project)Project milestones carry no state in Linear, so it is derived from the target date — past → completed, future → upcoming.
    • JiraRelease versions — released → completed; archived but unreleased → skipped; unreleased and past its release date → active; otherwise upcoming. Date from the release date.
    • ShortcutThe objective's epics — archived → skipped; epic done → completed; in progress → active; to do → upcoming. Date from the deadline.
    • YouTrackAgile board sprints — archived → skipped; otherwise derived from the finish date (past → completed, future → upcoming).
    • Azure DevOpsProject iterations — derived from the finish date (past → completed, future → upcoming).
    • AsanaThe project’s milestone tasks — completed → completed; open and past its due date → active; otherwise upcoming. Date from the due date.
    • CSVYou map the status column yourself in the browser; values we don’t recognize fall back to upcoming.

    Whichever way it’s read on import, you can edit any milestone’s status afterward — the import is just a starting point.

Sharing & collaboration

  • Can I make a board public and read-only?

    Yes — one toggle gives you a link customers or investors can open without an account, with no edit access. Flip it back to private any time. And when a live link doesn’t fit — a slide deck, an email, a data room — download the board as a PNG, SVG or PDF instead.

  • How do roles and permissions work?

    Every member of a private board has one of three roles:

    • Owner — full control: edit the roadmap, manage members and their roles, change visibility, and delete the board.
    • Editor — can build and change the roadmap (milestones, branches, the board’s name, description, and public/private toggle), but can’t manage members or delete the board.
    • Viewer — can’t change the roadmap, but can read it and follow the discussion: open any milestone on the shared board to read its comments (and post replies when the board is on a paid plan).

    Only an owner can invite people or change roles, and a board always keeps at least one owner — you can’t remove or demote the last one.

  • Can I invite my team?

    Yes — an owner invites teammates by email and picks each one’s role (new invites default to editor). If someone doesn’t have a Roadmark account yet, the invite waits for them to sign up, and it expires if it goes unused. How many named collaborators a board can have follows the owner’s plan — Free is single-user, Pro fits a small team, and Team is unlimited; public read-only link sharing is always free and never uses a seat. Reaching the limit only blocks new invites — no one is ever removed if a plan changes.

  • Can my team and I work on a board at the same time?

    Yes — boards are live. You’ll see who else is on a board, their cursor moving across the canvas, and a marker on any milestone someone is editing. Edits to different fields merge automatically; if two people change the same field at once, Roadmark asks before anything is overwritten rather than silently losing a change. Each milestone also has a comment thread, so the discussion about a decision lives next to it. Anyone on the board can read it — open a milestone on the shared board, viewers included — and comments are visible to board members only. Posting a comment is part of the paid plans (the board needs an owner on Pro or Team); on a Free board the thread stays readable but read-only. Type @ in a comment to mention a teammate — or @here to ping everyone in the thread and @board for the whole board. When a comment mentions you, the milestone shows an amber marker on the canvas so you spot the ping without opening every thread. Off the board, Roadmark emails you a once-a-day digest of new comments on the milestones you’re part of — the ones that mention you, plus replies in threads you’ve joined — and what you’ve read is synced across your devices, so a thread you opened on your laptop won’t still look unread on your phone. You can turn the digest off anytime in your account settings, or with one click from any email.

  • What happens to abandoned or forked branches?

    They stay on the canvas on purpose — the discarded path and the decision log explaining why you left it are the whole point of Roadmark, not clutter to clean up.

AI

  • How does AI roadmap generation work?

    Paste your own Anthropic, OpenAI, or Google key (we auto-detect the provider from the key), then open the AI generator right in the board editor. It’s not just for a blank start: it reads your board’s description and the milestones already on the branch you’re working in, so it can draft a fresh roadmap or extend an existing one. You review, edit, deselect, and set dates on the proposals before any of them land on the board — a draft you shape, not a locked-in plan.

  • Do you store my key or my prompts?

    Your key is encrypted at rest and never logged in plaintext. Prompts go only to your chosen provider at generation time, and aren’t used to train anything.