Engage users and manage new features from suggestion to changelog.
Knowledge base: maps
Managing your maps
How do I create a new map?
If you don't have any maps yet and don't belong to any teams, you can create a new team and free map here.
If you're on a free plan and already have one map, you'll need to upgrade to the paid plan in order to create another map. You can upgrade from your team's profile page. Scroll down to Billing and click the "Upgrade" button.
If you're already on a paid plan, you can create a new map from your team's profile page. Scroll down to the Billing section and click the "Create map" button.
How do I suggest a new feature for Changemap?
Changemap has its own changemap! Visit it and suggest a new feature or add your vote to an existing request.
How do I manage my task categories?
Each task can have a category, represented by an emoji. This list of categories is shared among all maps in your team.
Go to your team's profile page, then click "Categories" in the menu. Here you can add, edit, and delete categories so you can best represent the types of tasks in your maps.
How do I delete a map?
Go to the profile page for your map, and under the profile section click the link "Delete map". Complete the form to delete your map entirely. This action is irreversable, so we can't recover your map if you change your mind.
If you merely want to archive your map without deleting it, so that it isn't publicly available and doesn't count towards your subscription, you can edit your map's profile and untick the box "Active map".
Remember you can always export your map's data first if you want to keep a backup.
How do I manage my map's lists?
Go to your map's profile page and click "Lists" in the menu. Here you can edit, delete, and create new lists to hold tasks in your map. Lists have a "role" which determines things like their icon colour and the order they go in, as well as whether they allow things like suggestions and comments by default. Choose the role that most closely relates to what you'll use this list for, but feel free to rename it as required.
Roles
Changemap allows multiple lists with the same role, but works best when there is only one list with any one role. For example, tasks in a "Completed" list are grouped by date, so there's generally no reason to create multiple completed lists called "Completed this week", "Completed last month" and so on. Still, you may have good reason to have multiple "Planned" lists with different names like "Next release" and "Longer term", for example, and this is entirely possible.
Comments and votes
Allowing comments on all lists is quite reasonable, as people generally won't want to comment much on tasks that are completed. If tasks in your Rejected or On Hold list get a lot of heated discussion, you can always choose to lock comments on the individual task, or turn off comments for this whole list as a last resort.
Allowing votes on completed tasks doesn't make sense, as these tasks typically won't get updated beyond this point. For all other lists, allowing votes is useful in giving you a way to gauge the popularity of a task.
Suggestions
Task suggestions should only be allowed on a single list (typically called "Suggestions") to minimise confusion for your users. Suggestions can be triaged to other lists as required.
How do I disable comments on a task?
Go to your task's detail page and click the "Edit" button. Once you're in editing mode, tick the box titled "Disable comments" and hit the "Save" button. All existing comments will be preserved, but new comments won't be allowed.
How do I view my map's dashboard?
Every map has a dashboard showing statistics and an overview of recent activity. Here you can see pending and trending tasks, recent comments, and recent activity by your team members.
Go to your map's home page and click the "Dashboard" button under the welcome message, or from the menu.
How do I reorder tasks and lists?
Lists
The lists in your map are ordered according to their role. A role represents which stage of the task lifecycle the task is in, for example "planned" or "in progress". Here's the order lists are displayed in by role:
- Suggestions
- Under consideration
- Rejected
- On hold
- Planned
- In progress
- Completed
Lists can't be directly reordered, but if you assign a new role to a list, it will move on your map to fit the ordering of its role. For example if you make a list called "Not possible" and give it a role of "Rejected", this list will appear after your "Under consideration" list and before your "On hold" list, if you have one.
Tasks
Tasks are ordered within their list according to the role of the list. Most lists are ordered based on vote count, so that the most popular tasks are shown at the top. The "completed" list is ordered by date, showing the most recently completed at the top. Tasks can't be reordered within a list.
How do I view vote details for a task?
Go to a task's detail page, and in the related details under the task title and description, click the vote count. This will take you to a vote breakdown page showing votes by year, so you can gauge popularity over time. This page also shows a full list of users who voted for the task.
How do I quickly switch between my maps?
Click your name in the Changemap menu at the top of the page to bring up the account dropdown menu. In this menu you'll see a list of all the maps that belong to your team. Click one to quickly go there.
How do I engage my users with my map?
There are a few things you can do to increase engagement.
- Make your map look its best: make sure it has a welcome message, a link to your site, and a profile picture. Make sure you and your team members all have profile pictures, so users can recognise you in the comments. Categorise your tasks.
- Increase your map's visibility: link to your map wherever you can. Share it on social media, put the link in the footer of your support and marketing emails, link to it from your app. Make it part of your regular communication with your users. If you otherwise share your work publicly, link to the relevant task in your map when you share an update on your progress. Embed a Changemap widget of recently completed tasks into your site or app.
- Encourage users to participate: where you mention your map, use wording like "Suggest a new feature" or "See what's coming next" to engage users. If a user suggests a feature via support request, create a new task on your map for it and send them the link, encouraging them to vote for it. If you prioritise features based on popularity, remind users of this when you talk about upcoming features.
- Keep it active: If your map seems dead, users won't want to engage. Keep listing your work there, even if it's not a user suggestion. Keep updating your tasks' status. Reply to user comments and approve their suggestions in a reasonable timeframe.
How do I filter tasks by category?
Find a task that belongs to the category you're after, then click through to the task detail page. Click the category emoji on the top right of the task, and you'll be taken to a page showing all results for this category.
Can I have a private map or private lists?
At this stage, private maps and lists are not possible.
Importing, exporting, and integrations
Can I import tasks from other services?
Yes, currently we support importing tasks and lists from Trello. When you create a new map you have the option of importing a Trello board.
If you want to automate this, you can use our API to import or otherwise sync tasks from other services programmatically.
How do I create a widget for my site?
Widgets are embeddable content for your site, providing an easy way to show a subset of one of your map's lists. A common use for a widget is to show the Completed list, where you'll automatically see the most recently completed tasks. You may also want to show the most popular suggestions, for example. Use this on your site or in your app to engage your users in your public roadmap and show your progress.
Go to your map's profile page and click "Widget" in the menu. From here you can customise your widget and generate the code required for embedding. You'll need to have the ability to include HTML and Javascript in your site for this to work.
How do I export my map's data?
Go to your map's profile and click "export data" under the profile form. You'll get a JSON export of all the map's details.
How do I create an API token?
Please refer to the authentication section in our developer docs.
How do I connect Slack?
Slack can be connected and customised for each map you own. Visit your map's profile page, then click "Slack" in the menu. Click the "Connect" button and follow the steps to allow Changemap access to your Slack workspace. After this process is complete, you can customise which types of activity notifications to receive.