Install ThemeRouter and Check Requirements
Install ThemeRouter, confirm the supported WordPress and PHP versions, and prepare a safe test environment.
ThemeRouter documentation
Configure routes with a clear, production-safe workflow.
Start with installation and licensing, then learn how to preview themes, match content routes, and move changes into production safely.
Install and activatePrepare ThemeRouter and connect the license.
Create the first routeMatch content and choose the theme to serve.
Preview and validateReview the route before public activation.
Find the guide for your next step.
Search by task or follow a documentation path from setup through migration and troubleshooting.
Documentation paths
Configuration
1 article
Developer Reference
3 articles
Getting Started
2 articles
Migration Workflows
2 articles
Preview & Validation
3 articles
Theme Assignment
4 articles
Troubleshooting
4 articles
All guides
Activate Your ThemeRouter License
Activate a ThemeRouter license, verify the site connection, and find account or billing controls.
Access and Understand ThemeRouter Settings
Find ThemeRouter settings and understand preview, assignment, cache, logging, and debugging controls.
Preview an Installed WordPress Theme Privately
Preview an installed theme as an authorized user without changing the public active theme.
Preview Mode vs Theme Assignment
Choose between a private temporary preview and a persistent visitor-facing theme assignment.
Assign a Theme to One Post or Page
Create or remove an individual theme assignment from the block editor or classic editor.
Assign Themes to Post Types and Taxonomies
Assign installed themes to post types, post type archives, or taxonomy archives from ThemeRouter settings.
Understand Theme Routing Priority
Learn which theme wins when individual, post type, taxonomy, and active-theme rules overlap.
Remove a Theme Assignment or Roll Back a Route
Safely remove an individual or global assignment and confirm the previous theme is serving the route again.
Plan a Gradual WordPress Theme Migration
Create a route-by-route migration plan with validation gates, rollout order, owners, and rollback criteria.
WooCommerce Theme Migration Checklist
Plan and validate a WooCommerce theme migration without starting with the highest-risk customer flows.
Theme Compatibility and Validation Checklist
Validate templates, menus, assets, plugins, SEO, accessibility, and performance before assigning a theme.
Enable ThemeRouter Logging and Frontend Debugging
Use ThemeRouter logs and administrator-only frontend debug output to inspect routing decisions.
Troubleshoot a Theme That Is Not Switching
Diagnose missing assignments, routing precedence, permissions, theme availability, rewrites, and caching.
Resolve Page and Custom Post Type URL Collisions
Diagnose ambiguous URLs shared by pages and custom post type routes, then choose a stable resolution.
Synchronize Classic Menus and Block Navigation
Review and synchronize menu data when a migration crosses classic and block theme navigation systems.
Preview and Debug Permissions
Understand the default capabilities for private preview, persistent assignments, settings, and debug output.
Developer Hooks and WordPress Abilities API
Reference ThemeRouter filters for collisions, permissions, menu sync, and its read-only WordPress abilities.
Prepare a ThemeRouter Support Request
Collect the environment, route, assignment, cache, and debug details needed to investigate a ThemeRouter issue.
Still need help with a route?
Share the URL, assigned theme, environment details, and expected result so support can help faster.