Roadmap - Visual Project Planning Made Simple
Transform your Azure DevOps project planning with beautiful, interactive timeline views. Roadmap helps you visualize your entire project portfolio, track dependencies, and keep everyone aligned—all through simple queries.
🎬 Quick Start Videos
New to Roadmap? Watch these short clips to get started:
What You Can Do
Visualize Your Timeline
- See the big picture: View epics, features, and tasks in a beautiful Gantt chart
- Track connections: Visualize dependencies between work items
- Know who's working on what: See assignees directly in the timeline
- Auto-align to sprints: Automatically position items based on their iteration
- Focus on what matters: Zoom in/out and collapse sections as needed
Edit On the Fly
- Drag to reschedule: Change dates by simply dragging timeline bars
- Connect dependencies: Link related items with a quick drag-and-drop
- Review before saving: Changes don't take effect until you click Save
Getting Started
Step 1: Install the Extension
- Go to the Azure DevOps Marketplace
- Click Get it free
- Select your Azure DevOps organization
- Complete the installation
Note: You need to be an Organization Administrator to install extensions.
Step 2: Choose Your Plan
Roadmap offers three plans to fit your needs:
- Free: Perfect for trying out Roadmap (1 user)
- Basic: For small teams
- Premium: Full features for larger teams (includes PDF export, auto-align to iterations, and more)
To subscribe:
- Go to your organization settings at
https://dev.azure.com/YOUR-ORG/_settings
- Click Extensions → Roadmap
- Select your plan and follow the prompts
Creating Your First Roadmap
1. Organize Your Backlog
Create a clear hierarchy in your backlog (if you haven't already):
- Epics contain Features
- Features contain User Stories
- Stories contain Tasks
2. Add Dates
Add "Start Date" and "Target Date" to your work items. You can:
- Fill them in your backlog
- Or add them later directly in the Roadmap view
3. Create a Query
Create a query to define what appears in your roadmap:
- Go to Boards → Queries
- Click + New query
- Add a filter (we recommend using tags, like "Project-Alpha")
- Save your query
4. Tag Your Work Items
Add your tag (e.g., "Project-Alpha") to all items you want in this roadmap:
- Select multiple items in your backlog
- Click Add tag
- Enter your tag and save
5. View Your Roadmap
- Go to Boards → Roadmap
- Select your query from the dropdown
- See your timeline come to life!
Working with Your Roadmap
Adjusting Dates
Simply drag the edges or entire bars to change start and end dates.
Adding Dependencies
Drag from one item to another to create a dependency link.
Opening Work Items
Right-click any bar to open the full work item details.
Saving Changes
Important: Click the Save button when you're done to persist all your changes!
Customization
Organization Settings
Customize Roadmap for your entire organization:
- Go to Organization Settings → Extensions → Roadmap
- Configure:
- Columns: Choose which fields to display
- Date fields: Specify which date fields to use
- Colors: Set colors for unplanned items
- Users: Add team members to your subscription
Project Settings
Adjust settings per project:
- Toggle visibility of work item titles
- Enable/disable features like "show done items"
- Configure sorting preferences
Advanced Features
Milestones
Create milestones by setting the start and end date to the same day. They'll appear as vertical lines in your timeline.
Auto-Align to Iterations (Premium)
Let Roadmap automatically position items based on their assigned sprints—no manual date management needed!
PDF Export (Premium)
Export your roadmap as a PDF with customizable orientation, format, and date ranges.
Progress Tracking
See completion percentages displayed directly on timeline bars and in the tree view.
Filtering & Sorting
Filter by any column (tags, assignees, states) and sort by priority, dates, or custom fields.
Managing Your Subscription
Click Manage your subscription in the extension settings to:
- Upgrade or downgrade your plan
- Update payment methods
- Modify billing information
- View invoice history
What's New
Latest Updates (v1.17)
- Persistent Layout Per Query: Automatically save and restore your preferred layout for each query
- Tree list column widths are now remembered
- Task list width persists across sessions
- Zoom level is automatically saved and restored per query
- Horizontal scroll position is maintained when switching between queries
- Expanded/collapsed task states are preserved for each query
- Mouse Wheel Zoom: Use Ctrl + mouse wheel to zoom in and out of the timeline
- Smart Date Defaults: Automatically set start and end dates for unplanned tasks
- Enhanced user experience with improved settings persistence
Recent Updates (v1.16)
- Support for showing manually planned items alongside iteration-aligned items
- Toggle this feature with the new "Align workitems not assigned to an iteration" setting
Previous Improvements (v1.15)
- Fixed critical saving bug
- Enhanced PDF export with better typography
- Simplified interface by streamlining priority ordering
See full release notes
Need Help?
Common Questions
Q: Can I use Roadmap for free?
A: Yes! The Free plan supports one user with core features.
Q: What query types are supported?
A: All Azure DevOps query types, including "Tree of work items."
Q: Can I customize the date fields?
A: Absolutely! Configure any date/time field in the organization settings.
Q: Does it work with Azure DevOps Server?
A: Yes, it supports Azure DevOps Server 2019 Update 1.1 and newer.
Get Support
For questions or issues, reach out through:
- Your subscription email
- The Azure DevOps Marketplace Q&A section
Release Notes
1.17.xx
- Persistent Layout Per Query: Automatically save and restore your preferred layout for each individual query
- Tree list column widths are now remembered
- Task list width persists across sessions
- Zoom level is automatically saved and restored per query
- Horizontal scroll position is maintained when switching between queries
- Expanded/collapsed task states are preserved for each query
- Mouse Wheel Zoom: Use Ctrl + mouse wheel to zoom in and out of the timeline
- Smart Date Defaults: Automatically set start and end dates for unplanned tasks
- Enhanced user experience with improved settings persistence
- Fixed stale user settings issue when using wheel zoom feature
1.16.xx
- Roadmap now supports showing manually planned workitems in parallel to iteration-aligned items
- New setting: "Align workitems not assigned to an iteration"
1.15.xx
- Fixed critical bug where saving was returning before operations completed
- Enhanced PDF export with PT Sans font support
- Streamlined UI by removing backlog priority ordering
1.14.xx
- Improved milestone visibility (now behind tasks for easier drag & drop)
- Fixed export visibility bugs
1.13.xx
- Multi-select support for tag filtering
- Fixed column and bar rearrangement issues
1.12.xx
- Smart workitem field mapping feature
- Minor bugfixes
1.11.xx
- Reordered project-settings
- Added the ability to switch on/off even/odd row colors
- Group by AreaPath feature - adds a virtual root-level for each AreaPath
1.10.xx
- Enhanced PDF export with customizable issue and date ranges
- Fixed bug where PDF export sometimes resulted in errors
- Fixed bug querying cross projects not showing any gantt
1.9.xx
- Fixed issue where PDF export was not successful
- Provided export dialog for customizing PDF export (orientation, document format, range)
1.8.xx
- Progress tracking feature available - displays completion percentages on bars and in gantt view
- Minor fixes and improvements
1.7.xx
- Added localization support inherited from the browser
- Added scaling/zooming from days to years
1.6.xx
- Milestones feature released - vertical lines appear when start and end dates are identical
- Support for custom states - custom states in inherited process templates
- Filtering and sorting on each configured column
- Search for specific issues and sort by priority
- Minor fixes and improvements
1.5.xx
- Minor fixes and improvements
1.4.xx
- Auto-align to iteration feature (Premium) - automatically align issues by assigned iteration/sprint
- Updated Settings Panel with tooltips
1.3.xx
- Autoload the last selected query by project
- Bugfixes and performance improvements
1.2.xx
- Show or hide 'done' issues
- Define issue ordering in gantt (Start-Date or backlog-priority sorting)
1.1.xx
- View issue assignees (resources) inside the gantt
- Support for all account types (On-Premises, Active Directory, Microsoft 365, Microsoft Entra-ID)
- On-Premises compatibility fixes
1.0.xx
- First final (non-preview) release
- New design perfectly fitting Microsoft Azure DevOps Services/Server
- Added paid versions with subscriptions
- Organizational settings - customize treeview columns, colors, and Start/End-Date fields
- Project settings - inline, outline or hide work item titles
- PDF Export support (Premium)
0.4.xx
- Current date visible as vertical dashed line
- Manual and automatic jump to current date in gantt
- Support for all query types including "Tree of work items"
0.3.xx
- Unplanned workitems appear as red-colored bars
- Toolbar buttons for zoom in/out and collapse/expand
- New design with DevOps colors
- Sorted queries by name
- Performance improvements for loading work items
- Fixed scaling/zooming issues
0.2.xx
- Made extension downloadable
- On-Premises support (Azure DevOps Server 2019 Update 1.1+)
0.1.xx
- Display issues without parent in query result (appears on root-level)
- Edit issues from other projects within the organization
Made with ❤️ by QUIBIQ
