Troubleshooting Pods

When things go wrong, our troubleshooting section will help you identify at least where the problem is and hopefully resolve it.

Can’t get something to work properly or you’re having some odd problem that you can’t really isolate? This section discusses the more ‘behind the scenes’ workings of Pods so you can either get your Pods installation working properly again, figure out what might be going wrong on your site, or determine where things are stored in the database. We also include all the Pods Admin settings and components and what they do, as well as the wp_config.php parameters and directives specific to Pods.

For good measure, we’ve also provided some general troubleshooting ‘pointers’ for debugging your PHP and determining what’s going on in your WordPress Installation.

More Documentation on this Topic

Pods Admin

All the management functions of Pods described in one place.

Read more…

Pods Constants for wp-config.php

All of the available constants that you can override in the wp-config.php for Pods.

Read more…

URL Parameters for Debugging Pods

Add these to your URL to override specific settings or to provide additional debug details.

Read more…


  • Help! I keep getting 404 errors!

    Visit your Settings, Permalinks in the WordPress Admin. You don’t have to make any changes, just visit the Settings page and hit Save. This should correct the issue.

    If it keeps cropping up, that means you’ve got something else in your theme or in other plugins that is messing with rewrites. You can look through your site to see if your theme or any other plugins are calling `flush rewrite rules` which is the usual thing if it’s called improperly that will give you 404’s.

    To look for plugin conflicts, use our Theme & Plugin Conflict FAQ.

  • Help! Something in Pods broke my theme or another plugin!

    You’ll hear this often from any plugin or theme developer:

    “Try turning everything else off and switch to a base theme and see if it you still have the issue.”

    We know this is frustrating to hear, but try to look at it from this viewpoint: It is impossible for us to test our plugin with every single theme or plugin out there. We code to WordPress standards and for themes and other plugins that also adhere to those standards.

    In order to properly troubleshoot what appears to be our plugin breaking your website, you often will need to turn off everything else but our plugin and a standard “Twenty-something” theme from WordPress to rule out the issues.

    To look for plugin or theme conflicts, you can either:

    1. Turn off all plugins but pods and your theme and see if you have the issue. Turn on one plugin at a time until the issue reoccurs. When it does, that’s the plugin or theme that is conflicting. Or,
    2. Use the Health Check plugin ( Troubleshooting Mode. It will do the same thing in a safe space for your account only so it won’t impact your live site. The plugin explains itself very well, but basically in troubleshooting mode, you’ll be shown an instance of your website with all plugins disabled and a basic theme. You can turn on plugins one a time (there’s an admin menu items called ‘Troubleshooting Mode’ that allows you to do this easily. This will help you route out what is causing the problem.