All Collections
Integration Settings
Troubleshoot Common WooCommerce Integration Problems
Troubleshoot Common WooCommerce Integration Problems
Here's why your WooCommerce site may not connect to Pirate Ship
Updated over a week ago

There are many reasons why a WooCommerce store may have some trouble connecting to Pirate Ship. The steps below will go over some easy settings to check, but you may need to reach out to your site developer for further assistance πŸ˜‰

  • Is your website live? Pirate Ship won't be able to connect to your store if your website is under maintenance, or in password-protected mode.

  • Are you trying to connect to the base URL? For example, you should be connecting to, not πŸ‘

  • Does your setup meet the minimum requirements?
    - Your WooCommerce plugin should be at least version 2.6 or newer.
    - Your WordPress installation must be at least version 4.4 or newer.
    - You must have an SSL certificate installed on your website (https://)

  • Try logging out of WooCommerce and PirateShip, then try logging in again and enter your credentials manually. Sometimes this helps refresh the connection and get your integration up and running again πŸ’ͺ If you get to the login window in WooCommerce, it will look like this:

  • If you go to, do you get an error, or a ton of code? (For example,
    - Getting a page full of code is a good sign πŸ™‚
    - If you see an actual error, the built-in API for your website was disabled or deleted. You'll need to work with your website developer to add it back!

  • Do you have a firewall? Sometimes firewalls will block unknown User Agents πŸ™ˆ

    You will want to be sure to whitelist Pirate Ship's User Agent String ("Pirate Ship WooCommerce Integration"). Your web developer can test if everything is working by running the following command: curl --verbose --user-agent "Pirate Ship WooCommerce Integration" You should then receive an HTTP response (200) and JSON result of your store configuration.

  • Are you using the right admin credentials to log in to WordPress? To connect the Pirate Ship integration to WooCommerce, you'll need to log in to WordPress using the admin credentials associated with your WooCommerce account, not just another site admin (such as your tech admin, for instance).

Still hitting rough waters? Chat in with our Support Crew so we can get you sailin' in the right direction β›΅

Did this answer your question?