Guide

Taxonomies troubleshooting

Recurring URL and taxonomy issues.

New rewrite config does not take effect

Cause: Rewrite rules were not flushed after config changes.

Fix:

wp rewrite flush

Flush on activation only in code; do not call flush_rewrite_rules() on every request.

Post URL missing the research team prefix

Cause: Blog ID is 1, primary term is unset, post type is not in rewrite config, post is not publish, or disable_research_team_permalink is set.

Fix: Confirm primary research team, post type enablement, and blog context. Primary term helpers require prc-schema-seo.

Unexpected 404 on a team-prefixed URL

Cause: First segment collided with an excluded slug, or the captured slug is not a valid research-teams term.

Fix: Avoid research team slugs that match post type or core paths. Verify the term exists and the date/name path matches the post.

Cause: Editors or old content still emit the legacy base.

Fix: Topic base is /topic/. Legacy redirects are owned by vip-config/server-redirects.php in this plugin.

Was this helpful?