Automattic

Daniel Bachhuber

Gary Jones

Tim Moore

A simple WordPress admin tool for inspecting rewrite rules. View a listing of all your rewrite rules, see which rewrite rules match a given URL (and the priorities they match in), or filter by different sources of rewrite rules. Perform a soft flush of your rewrite rules to regenerate them.
<a href="https://github.com/Automattic/Rewrite-Rules-Inspector/" rel="nofollow ugc">Developed on GitHub</a> — pull requests are always welcome. Please leave feedback, questions, bug reports, and feature requests in the GitHub issues.
<h3>Where to find it</h3>
Go to <code>Tools → Rewrite Rules</code> in the WordPress admin.
<h3>URL Tester</h3>
Quickly test any URL (or path) against your site’s rewrite rules:
<ul>
<li>See whether the URL would be a 404 or which rule would match first (the one WordPress uses).</li>
<li>View the list of all matching rules, in match priority order.</li>
<li>Inspect the query variables extracted from the match and the resulting final query WordPress would run.</li>
</ul>
Works with full URLs or paths and automatically handles sites installed in a subdirectory.
<h3>Permastructs</h3>
Browse a table of all permastructs that WordPress is aware of, including:
<ul>
<li>Name — the permastruct key (e.g. for posts, taxonomies, authors).</li>
<li>Structure — the permalink structure pattern used to generate rules.</li>
<li>Description — a human-friendly summary of what the permastruct controls.</li>
</ul>
<h3>Flush Rules</h3>
The “Flush Rules” button allows you to regenerate your site’s rewrite rules. Here’s exactly what happens when you click it:
<h4>What the Flush Rules Button Does</h4>
When you click the “Flush Rules” button, the following sequence occurs:
<ol>
<li>
Security Check: The system verifies you have the proper permissions (<code>manage_options</code> capability) and validates the security nonce to prevent unauthorized access.
</li>
<li>
Cache Clearing: WordPress deletes the cached rewrite rules from the options cache using <code>wp_cache_delete('rewrite_rules', 'options')</code>.
</li>
<li>
Rule Regeneration: WordPress calls <code>flush_rewrite_rules(false)</code> to regenerate all rewrite rules based on:
<ul>
<li>Current permalink structure settings</li>
<li>Custom post types and taxonomies</li>
<li>Any custom rewrite rules added by themes or plugins</li>
</ul>
</li>
<li>
Hook Execution: The <code>rri_flush_rules</code> action hook is fired, allowing other plugins to perform additional cleanup or actions after the flush.
</li>
<li>
Success Feedback: You’re redirected back to the Rewrite Rules Inspector page with a success message confirming the rules have been flushed.
</li>
</ol>
<h4>When to Use Flush Rules</h4>
Use the “Flush Rules” button when:
<ul>
<li>Missing Rules: You see rules marked as “missing” (red background) in the inspector</li>
<li>Custom URLs Not Working: Your custom permalinks or post type URLs aren’t working properly</li>
<li>After Plugin Changes: You’ve activated/deactivated plugins that register custom rewrite rules</li>
<li>Permalink Structure Changes: You’ve modified your site’s permalink structure</li>
<li>Custom Post Type Issues: New custom post types or taxonomies aren’t generating proper URLs</li>
</ul>
<h4>Important Notes</h4>
<ul>
<li>Soft Flush: This performs a “soft” flush (using <code>flush_rewrite_rules(false)</code>), which is safer than a hard flush as it doesn’t force regeneration of all rules unnecessarily.</li>
<li>Permissions Required: Only users with <code>manage_options</code> capability can flush rules.</li>
<li>No Data Loss: Flushing rules doesn’t delete any content or settings, it only regenerates the URL routing rules.</li>
<li>Immediate Effect: Changes take effect immediately after flushing.</li>
</ul>

Rewrite Rules Inspector

Best option when working with permalinks and custom urls structs

A must have for permalinks work

Easy Testing what wordpress rewrite thinks about any url ;) 

Nice one!


Sometimes you get into a trap that logically leads nowhere and this plugin can help you find a way out of this vicious circle. Thanks.


Genius tool for debugging redirect errors

A simple admin tool for inspecting rewrite rules.

Alley

Matthew Boynes

This plugin provides a simple interface for testing your custom rewrite rules.
The purpose of this plugin is to be able to test your own rewrite rules, so 
you’re probably most interested in knowing how to do that, right? The plugin 
provides a filter, <code>rewrite_testing_tests</code> to add your own tests. That filter 
passes an associative array of name => tests. The tests array is an associative 
array of URI => expected match. In the outer array, the “name” is arbitrary and 
for your own reference. In the inner array, the “URI” is the path you want to 
test, and the “expected match” is what WordPress should find as a rewrite 
match.
Enough chit-chat, here’s an example:
<pre><code>function my_rewrite_tests( $tests ) {
 return array(
 'Events' => array(
 '/event/super-bowl/' => 'index.php?event=$matches[1]',
 '/event/super-bowl/page/2/' => 'index.php?event=$matches[1]&paged=$matches[2]'
 )
 );
}
add_filter( 'rewrite_testing_tests', 'my_rewrite_tests' );
</code></pre>
You can see the <code>test_cases()</code> method for a full suite of tests for the “Day 
and Name” permalink structure. It’s not necessary to leave these in (in fact, 
the above demo would wipe them out), unless you want to make sure that your 
custom rewrites aren’t affecting core rewrites. If you aren’t using “Day and 
Name” permalinks, you’ll need to adjust the tests to fit your permalink 
structure.
<h3>Todo</h3>
<ul>
<li>Add a debug bar extension which reads a transient; the transient would be 
updated whenever rewrite rules are flushed. The debug bar extension would 
show pass/fail status and link directly to the settings page.</li>
<li>Add tests for other permalink structures?</li>
<li>Add a way to run this as part of phpunit</li>
</ul>

Rewrite Rule Testing

Regex and WordPress rewrite rules are probably my two Least Favourite Things, so this plugin is essential for making sure I haven't messed anything up :)



Nice

Unit test your rewrite rules from the WordPress Admin.

Rewrite Rules Inspector vs Rewrite Rule Testing