Pro Settings & Configuration

Get Started

Pro Settings & Configuration

Time to read: 5 minutes

Configure Pro-exclusive features including templates, import/export, and advanced options.

Accessing Pro Settings

  1. Go to Roadmap > Settings in WordPress admin
  2. Pro adds additional tabs to the settings page:

Templates Settings

Board View Options

SettingDescriptionDefault
Column WidthWidth of status columnsAuto
Card StyleCompact or detailed cardsDetailed
Show Progress BarDisplay progress on cardsYes
Show AssigneeDisplay assigned user avatarYes

Timeline View Options

SettingDescriptionDefault
Default View ModeDay/Week/Month/Quarter/YearMonth
Show DependenciesDisplay dependency linesYes
Show ProgressProgress bar on timeline barsYes
Row HeightHeight of timeline rows40px

Cards View Options

SettingDescriptionDefault
ColumnsCards per row (2-4)3
Show ExcerptDisplay item excerptYes
Excerpt LengthNumber of words25

Import/Export Settings

Export Options

SettingDescriptionDefault
Date FormatExport date formatYYYY-MM-DD
Include IDsInclude item IDs in exportYes
EncodingFile encodingUTF-8

Import Options

SettingDescriptionDefault
Max File SizeMaximum CSV upload size5MB
Default StatusStatus for items without onePlanned
Skip DuplicatesSkip items with matching titlesNo

For detailed import/export usage, see the Import & Export guide.

Advanced Settings

Performance

SettingDescriptionDefault
Cache DurationHow long to cache roadmap data1 hour
Lazy Load ItemsLoad items on scrollNo
Minify AssetsMinify Pro CSS/JSYes

Developer Options

SettingDescriptionDefault
Debug ModeEnable detailed loggingOff
REST API CacheCache API responsesYes
Custom CSSAdd custom stylesEmpty

Permissions

SettingDescriptionDefault
Drag & Drop RoleMinimum role for drag & dropEditor
Frontend ManagementAllow frontend item managementOff
Suggest Feature RoleWho can submit suggestionsEveryone

Product-Specific Settings

Note: Per-product setting overrides are not yet available. All settings on this page apply globally to every product. Per-product overrides (custom default template, status filter, voting toggle per product) are planned for a future release. For now, use shortcode attributes to customize behavior per product page — for example, [roadmap product="mobile-app" template="timeline"] displays a specific product with a specific template.

Option Key Reference

All Pro settings are stored in the wp<em>options table (the WordPress database table that stores site-wide settings). Use these keys when debugging, building custom integrations, or querying settings programmatically with get</em>option() (a WordPress PHP function that retrieves a stored setting value).

Feature Toggles

Option KeyValuesDefaultDescription
roadmap<em>pro</em>enable_webhooksyes / nonoEnable webhook event delivery
roadmap<em>pro</em>enable<em>feedback</em>widgetyes / nonoShow floating feedback button
roadmap<em>pro</em>enable_digestyes / nonoSend scheduled activity digests
roadmap<em>pro</em>enable_analyticsyes / noyesEnable the analytics dashboard
roadmap<em>pro</em>enable_timelineyes / nonoEnable timeline (Gantt) view
roadmap<em>pro</em>enable_dragdropyes / nonoEnable drag and drop management

Feedback Widget

Option KeyValuesDefault
roadmap<em>pro</em>feedback<em>widget</em>button_textstringFeedback
roadmap<em>pro</em>feedback<em>widget</em>colorhex color#4f46e5
roadmap<em>pro</em>feedback<em>widget</em>positionbottom-right / bottom-leftbottom-right
roadmap<em>pro</em>feedback<em>widget</em>displayarray of contexts(empty)

Email & Digest

Option KeyValuesDefault
roadmap<em>notification</em>emailemail addressadmin email
roadmap<em>pro</em>digest_frequencydaily / weeklydaily

Guest Suggestions

Option KeyValuesDefault
roadmap<em>pro</em>enable<em>guest</em>suggestionsyes / nono
roadmap<em>pro</em>guest<em>suggestion</em>require_nameyes / noyes
roadmap<em>pro</em>guest<em>suggestion</em>require_emailyes / noyes
roadmap<em>pro</em>guest<em>suggestion</em>rate<em>limit</em>per_ipinteger3
roadmap<em>pro</em>guest<em>suggestion</em>notification_emailemail addressadmin email
roadmap<em>pro</em>send<em>guest</em>notificationsyes / noyes

Display & Templates

Option KeyValuesDefault
roadmap<em>pro</em>default_templateboard / timeline / list / cards / minimalboard
roadmap<em>pro</em>default<em>view</em>modeday / week / month / quarter / yearmonth
roadmap<em>pro</em>card_stylecompact / detaileddetailed
roadmap<em>pro</em>max_productsinteger10
roadmap<em>pro</em>cache_durationinteger (seconds)3600
roadmap<em>pro</em>lazy_loadyes / nono
roadmap<em>pro</em>minify_assetsyes / noyes
roadmap<em>pro</em>debug_modeyes / nono

Additional Feature Toggles

Option KeyValuesDefault
roadmap<em>pro</em>enable_exportyes / noyes
roadmap<em>pro</em>enable<em>custom</em>fieldsyes / noyes

Data Storage (read-only reference)

These options store configuration data managed through other interfaces. Do not edit them directly in the database.

Option KeyTypeDescription
roadmap<em>pro</em>custom_fieldsarrayCustom field definitions (managed via REST API)
roadmap<em>pro</em>webhooksarrayWebhook configurations (managed via REST API)
roadmap<em>pro</em>webhook_logsarrayLast 100 webhook delivery logs (auto-managed)
roadmap<em>pro</em>email_templatesarrayCustom email template content (managed via Settings UI)
roadmap<em>pro</em>license_keystringEDD license key
roadmap<em>pro</em>license_statusstringLicense activation status

Global vs Per-Product Behavior

All settings on this page apply globally to every product. To customize behavior for a specific product on the frontend, use shortcode attributes:

[roadmap product="mobile-app" template="timeline" status="in-progress,planned"]

This displays only the “mobile-app” product with the timeline template, filtered to specific statuses. Each product page can use different shortcode attributes to create a tailored experience without per-product settings.


Resetting Settings

Reset to Defaults

  1. Go to Roadmap > Settings
  2. Scroll to bottom of any tab
  3. Click Reset to Defaults
  4. Confirm the action

This only resets settings — your roadmap items, votes, and data are preserved.


Troubleshooting

Settings not saving

  • Verify you clicked Save Changes at the bottom of the tab
  • Check your browser console for JavaScript errors that might block the form submission
  • Ensure your WordPress user has administrator privileges

Pro tab missing from Settings

  • Confirm the Pro addon is activated under Plugins
  • Verify the free Product Roadmap plugin is also active
  • Deactivate and reactivate the Pro addon

Cache settings not taking effect

  • If you changed the cache duration, clear your object cache (if using Redis or Memcached)
  • Page caching plugins (WP Super Cache, LiteSpeed, etc.) have their own cache — clear those separately
  • The roadmap<em>pro</em>cache_duration setting controls how long the plugin caches roadmap data internally, not browser or page cache

Next Steps

Last updated: March 4, 2026