Analytics, Export, Merge and Suggestions
Analytics or the CSV export is forbidden
Section titled “Analytics or the CSV export is forbidden”Symptom: the Analytics screen or the analytics CSV export refuses access, or the analytics REST routes return an authorization error.
Cause: the user lacks the roadmap_view_analytics capability. Administrators have it; other roles, including Contributors, do not unless it is granted.
Fix: grant the capability to the role that needs it, or use an Administrator account. If the CSV link says the security check failed, reopen the Analytics screen and click Export again, because the link carries a one-time nonce.
The item CSV export is refused
Section titled “The item CSV export is refused”Symptom: exporting items under Roadmap > Settings > Import/Export shows a permission error.
Cause: the item export requires the WordPress export capability, and CSV import requires manage_options.
Fix: run the export or import as an Administrator. See CSV import and export.
Analytics is empty
Section titled “Analytics is empty”Symptom: the dashboard shows no data.
Cause: events are pruned past the retention window (90 days by default), the product or period filter excludes the data, or tracking requests are being rate limited (below).
Fix: set the Product filter to All Products and widen the Period. Raise Analytics Retention (days) under Roadmap > Settings > Advanced for future data; pruned events cannot be recovered.
Tracking requests return 429 or 413
Section titled “Tracking requests return 429 or 413”Symptom: calls to /roadmap/v1/analytics/track fail with 429 too_many_requests or 413 payload_too_large.
Cause: the endpoint allows 30 events per minute per IP address and a 2048 byte payload.
Fix: send fewer or smaller events. Behind a proxy or shared IP, visitors share the same limit.
Guest suggestions do not appear
Section titled “Guest suggestions do not appear”Symptom: visitors submit an idea but it is not on the board.
Cause: guest suggestions are saved as pending and only show once approved. The submitter must also be logged out; logged-in users use the regular suggestion form.
Fix: review Roadmap > Guest Suggestions and approve the entry. If visitors get a rate limit error, they exceeded the per-IP hourly cap (3 by default); a 409 duplicate_suggestion means the same title and email were sent from the same IP within 24 hours. See Guest suggestions.
Merge duplicates fails
Section titled “Merge duplicates fails”Symptom: Merge Into Selected shows an error, or the target item is not in the picker.
Cause: both items must belong to the same product (different_products error), the two items must differ, and you need permission to delete the source and edit the target. The picker only searches the source item’s product.
Fix: move the items to the same product first, then merge. See Item merge.
An item cannot be assigned to several products
Section titled “An item cannot be assigned to several products”Symptom: a save is rejected with 400 roadmap_single_product, or the Products panel is a single choice.
Cause: since 1.8.0 one product per item is the default; Quick Edit, bulk actions and CSV import also keep a single product.
Fix: use one product per item, or enable roadmap_allow_multiple_products. See Multi-product management.