Company Blog Support
Martin Cogburn


    Back to Top

    WordPress Integration Troubleshooting

    Start Here: If one of the following issues is affecting your WordPress site:

    • Membership permissions are not passing correctly
    • Members are able to log in but are not redirected to the right page
    • Shortcodes are not functioning properly
    • ‘On Error’ redirects are not working properly
    • Members are unable to access a protected page that they should have membership access to.

    Try this

    ...the first thing to try is to Clear PilotPress Cache which solves these issues the majority of the time. In order to clear the PilotPress cache log into the backend (dashboard) of your WordPress page and do the following:

    1. Go to Settings > Pilotpress > Advanced settings
    2. Click the button Clear PilotPress Cache
    3. Save

    Once you’ve done this, run a test to check if the issue persists. If it does, please contact our support team.

    How do I detect which WordPress plugin is causing a conflict with Pilotpress?

    Step 1: Deactivate all of your plugins

    1. Go to the Plugins page in your WordPress Dashboard and select all active plugins by clicking the check box in the header row. 

    2. Choose Deactivate from the drop menu and click Apply to deactivate all the plugins at once.

      deactivate all plugins

    3. Activate the Pilotpress plugin. Then, choose your next most important plugin and activate it.

    4. Test the installation with just the PilotPress and your second most important plugin activated. Follow this process when testing:

      1. Log out of your WordPress site completely. 
      2. Create a new Contact in ONTRAPORT for testing purposes. Add a Membership level to the contact. 

      3. Open a new private tab or window in your browser (see instructions for Firefox and Chrome). 

      4. In the private tab or window, clear the cookies for your Wordpress site. This step is required. To see instructions on how to clear your cookies, click HERE.

      5. Go to the default WordPress login page by adding "/wp-login.php" to your domain:

      6. Log in as your new contact and verify the installation works with the plugins activated. 

      7. If the test is successful, log the contact out of WordPress, close the private tab or window, and log back in as the Administrator. Activate the next most important plugin.  Repeat from step a. in this section. 

    What plugins cause conflicts with Pilotpress?

    Our plugin is compatible with many others. Some plugins use similar features or code which can cause the two plugins to conflict. 

    There are thousands of WordPress plugins available, and we can't test them all. But these are some things to watch out for:

    • Any other "membership" plugin (S2 Member, BuddyPress, etc.)

    • Any plugin that manages "redirection" 

    Caching plugins are in a special category. If the cache plugin has the ability to exclude your membership protected pages they can be used. Otherwise, the cache will display the page to any visitor to your site. Most caching plugins have an exclusion list or "do not cache" section.

    If you discover a plugin is incompatible with PilotPress please contact Support. We may have a method to overcome the conflict or, if we cannot make it work, will list it here.

    How do I detect if my WordPress theme is causing a conflict with Pilotpress?

    1. Go to Appearance > Themes in your WordPress Dashboard

    2. Deactivate your current theme.

    3. Activate a basic theme such as Twenty Fifteen

    4. See if your functions work as normal.

    How do I troubleshoot basic Pilotpress Issues?

    To do this, first make sure your website is properly integrated with ONTRAPORT.

    1. Log into ONTRAPORT

    2. Go to the Navigation bar > Sites menu > WordPress.

    3. Click on the name of your WordPress site and note the info here

    4. Check for the Pilotpress plugin in WordPress

      1. Login to the backend of WordPress

      2. Click on Plugins

      3. Make sure Pilotpress is installed and active.

      4. Make sure you have the latest version of Pilotpress.

    5. Verify that the API from ONTRAPORT matches that in the WordPress backend.

      1. Login to the backend of WordPress by going to

      2. Go to Settings > PilotPress and make sure the APP ID and API Key match the values in ONTRAPORT for the site under Sites > WordPress

    6. If everything mentioned above is set up as described, contact our support team.


    How Do I Revert to a Prior Version of PilotPress?

    If you update to a new version of PilotPress and experience problems, you can revert to a prior version. Contact Support for a prior version of the plugin. 

    Why won’t you fix my WordPress site?

    WordPress is an open source content management system and is a third party outside of ONTRAPORT. While our support is amazingly helpful, we would not want to risk causing damage to your website. Because of this, our support ends at our Pilotpress functionality. We will ensure that Pilotpress is working on your website without other plugins or theme enhancements. It is our user’s responsibility to ensure that other plugins or themes do not cause conflicts.




    WordPress Integration Resources




    Articles in this section

    Created - Updated
    Have more questions? Submit a request


    • Avatar
      Devin Slavin


      I just wanted to give everyone a heads up that PilotPress wasn't locking down my pages and I figured out why. As per OntraPort Support's suggestion I disabled all plugins one-at-a-time and found Yoast SEO was the problem plugin.

      So watch out if you're using Yoast and want to lock down content with PilotPress. I love Yoast! I hope the conflict can be resolved at some point soon...



    • Avatar
      erin peloquin

      Thanks for posting, Devin. I'm experiencing this also. And I'd really like to use Yoast. Have you found a good alternative to it?

    • Avatar
      Devin Slavin

      Hi Erin, I haven't done it yet. Actually running no SEO plugin at the moment as I haven't had time to find a replacement. Let me know if you find one as well. Thanks! :)

    • Avatar
      Frank Hagan
      Edited by Frank Hagan
    Powered by Zendesk