Roadmap setup

The roadmap is a visual representation of your development progress that shows users what you're working on and what's coming next. Learn how to configure and manage your roadmap effectively.

Understanding the roadmap

What is the roadmap?

The roadmap displays issues organized by their current status, showing users:

• What's planned: Issues in early stages
• What's in progress: Currently being worked on
• What's completed: Recently finished work
• What's coming next: Upcoming priorities

Roadmap benefits

• Transparency: Keep users informed about progress
• Expectation management: Set realistic timelines
• Community engagement: Show you're listening to feedback
• Priority communication: Highlight important work

Configuring roadmap visibility

Status-based display

1. Go to Project Settings → Statuses
2. For each status, toggle "Show in roadmap"
3. Only enabled statuses will appear on the public roadmap
4. Reorder statuses to control column sequence

Recommended status configuration

• Planned: Show future work
• In Progress: Show current work
• Testing: Show work being tested
• Completed: Show recent releases

Status ordering

• Left to right: Arrange statuses in workflow order
• Logical progression: Follow your development process
• User-friendly: Use terminology users understand
• Consistent: Maintain consistent ordering

Roadmap layout

Kanban-style columns

• Column headers: Status names as column titles
• Issue cards: Issues displayed as cards
• Drag and drop: Team members can move issues
• Visual progress: Clear workflow representation

Card information

• Issue title: Clear, descriptive title
• Category: Visual category indicator
• Vote count: Show community support
• Last updated: Recent activity indicator

Responsive design

• Mobile view: Optimized for mobile devices
• Tablet view: Adapted for tablet screens
• Desktop view: Full-featured desktop experience
• Touch-friendly: Easy touch interactions

Customizing the roadmap

Visual customization

• Column colors: Customize status colors
• Card styling: Modify issue card appearance
• Layout options: Choose different layouts
• Branding: Match your brand colors

Content customization

• Column titles: Customize status names
• Descriptions: Add status descriptions
• Instructions: Guide users on roadmap usage
• Links: Add relevant links and resources

Display options

• Issue count: Show number of issues per status
• Progress indicators: Visual progress bars
• Timeline view: Show estimated completion dates
• Priority indicators: Highlight high-priority items

Managing roadmap content

Issue placement

• Automatic placement: Issues appear based on status
• Manual placement: Override automatic placement
• Bulk updates: Move multiple issues at once
• Status synchronization: Keep roadmap current

Content updates

• Regular updates: Keep statuses current
• Progress communication: Update users on progress
• Timeline adjustments: Modify estimated dates
• Priority changes: Update issue priorities

Quality control

• Content review: Ensure accurate information
• Status verification: Confirm correct statuses
• User feedback: Incorporate user input
• Continuous improvement: Refine roadmap over time

Best practices

Roadmap design

• Keep it simple: Don't show too many statuses
• Clear progression: Logical workflow sequence
• User-friendly: Use terminology users understand
• Consistent updates: Regular status updates

Content management

• Accurate information: Keep roadmap current
• Realistic timelines: Set achievable expectations
• Regular communication: Update users frequently
• Transparent process: Explain your workflow

User experience

• Easy navigation: Make roadmap easy to use
• Clear information: Provide helpful details
• Visual appeal: Use colors and icons effectively
• Mobile optimization: Ensure mobile compatibility

Advanced features

Timeline view

• Date-based: Show issues by timeline
• Milestone markers: Highlight important dates
• Progress tracking: Visual progress indicators
• Release planning: Plan future releases

Filtering options

• Category filters: Filter by issue categories
• Priority filters: Show high-priority items
• User filters: Filter by user submissions
• Date filters: Filter by creation or update date

Integration options

• Project management: Connect to external tools
• Development tools: Link to GitHub, GitLab
• Communication: Share roadmap updates
• Analytics: Track roadmap engagement

Roadmap analytics

Usage metrics

• Page views: Track roadmap visits
• User engagement: Monitor user interaction
• Popular issues: Identify most-viewed issues
• Status distribution: Analyze issue distribution

User feedback

• User surveys: Gather roadmap feedback
• Usage patterns: Understand user behavior
• Improvement suggestions: Collect improvement ideas
• Satisfaction metrics: Measure user satisfaction

Next steps

• [Publishing issues] - Move issues to changelog
• [Manual entries] - Create custom changelog posts