Find solutions to some unexpected issues encountered when using the BigCommerce for WordPress plugin.
Reading an error log is the first step in diagnosing common issues and error messages. To effectively troubleshoot problems, you must enable error logs and diagnostics for the plugin. From the WordPress admin panel, select BigCommerce > Settings > Diagnostics and click Enable Error Logs and Get Diagnostics. Now you’re set to determine which topic listed here can help you get back up and running.
These are the most common account issues:
The full list of scopes is on the Multi-site Setup page.
If the reset password email doesn’t appear in your inbox, check that your server/service isn’t blocking it. Also, check that the email functionality is on. The plugin relies on the settings set in WordPress.
The following topics cover solutions for product sync and import type errors.
If your product sync is stuck, or you’ve come across the message below, steps are available to get things back in sync.
The following steps will get your products syncing once again.
If the import still doesn’t work, contact BigCommerce support and/or create an issue in the GitHub repository. Be sure to provide as many details as possible, including the BigCommerce for WordPress plugin version, PHP version, and my SQL version.
The price on the product page often has the wrong value because of heavy caching. This incorrect value can happen due to an expired X-Nonce for price request. Fix this issue by removing that nonce from the price request.
You should take the following step:
If products are missing in the WordPress control panel, verify that you have assigned the products to the corresponding channels. Ensure you have not turned off the Automatic Listing option for Full import in the plugin’s settings.
The import time depends on the number of products synced from your catalog. In general, if you have more than 200 products and use Full import, then it is normal for the import to run for more than 30 minutes.
Note that the import process also relies on WP-Cron. Import tasks are processed only when the site has visitors. To avoid this kind of issue, follow the Server Side Cron guide.
If you cancel the product import or see the following error below, ensure your channel is properly connected.
Check that you have connected your WordPress store to BigCommerce and set the primary channel under BigCommerce > Settings > Channel. If you did not set the primary channel, re-install the plugin and connect it to the correct store channel.
If products are no longer updating after an import, flush the cache on your WordPress setup. In some cases, pages and product information are cached, and old information displays.
The Fast Headless import doesn’t support the “New/Updated since last sync” (partial) option. The fast import option only retrieves categories, brands, and product IDs; all other information loads on the corresponding front page.
Check your primary channel settings in BigCommerce (example url: https://store-<store_hash>.mybigcommerce.com/manage/channel/<channel_id>/store-settings) and make sure that corresponding items in product display settings are visible.
Ensure that your channel attached to WordPress isn’t in pre-launch status. If it is in pre-launch status, change it to active and perform an import on the WordPress side.
If products are no longer syncing, or progress has stalled, check to see if WP-Cron is working. Determine if your WP-Cron job is running by using the plugin WP Crontrol.
Ensure you have a browser window open on the site; otherwise, the product import will continue to fail. If WP-Cron isn’t working, contact the site’s hosting provider.
In cases where cart and checkout pages won’t render correctly, try looking into these solutions.
Check to see if this is a cache problem. Each time you add a product to a cart, an API request is sent. Without a cache set, the cart’s content updates after successfully processing of the API request. However, if you apply cache rules, they can affect the cart and return the wrong version of the cart (e.g., empty cart page, not a sufficient amount of products, etc.).
To resolve the issue, exclude the cart page and mini-cart requests from the cache.
The following topics cover error messages that can occur with the plugin.
If you encounter an error on the “Add to Cart” button, or get the message below, try resetting the site’s redirects.
To reset the site’s redirects use the following steps:
When the plugin floods the error log with the following message:
This message appears if you’re running on PHP version 5.4 or lower. The plugin requires 5.6+ or higher to function properly.
When sending an API request and you get a 403 error, or encounter the following message:
Ensure that either the server or service isn’t blocking requests.
Be sure to whitelist requests to the BigCommerce API and the responses from it.
There are API scope issues if you get the error below:
When using the Fast (headless) import, apply the accurate scopes to your API keys. The Storefront API tokens and the Storefront API impersonation tokens require scopes. Create a new token with the correct scopes by going to Dashboard > Settings > Store-level API accounts.
If you encounter the following PHP errors (shown below) in your server logs related to the plugin, then extension-related issues could be the problem.
First, check that this is not a PHP extension specific issue, e.g. https://www.php.net/manual/en/function.ctype-alpha.php (function is disabled by hosting/service provider and similar). If that doesn’t resolve the issue, contact BigCommerce support, or create an issue in the GitHub repository.
If you see the following webhook error below, try resetting the webhooks in the BigCommerce control panel.
Use the following steps to reset the webhook settings:
If you get a 404 error or are confronting an issue with the URL, you can fix this in the WordPress control panel. Set the correct permalink structure in the WordPress admin panel by clicking Settings > Permalinks. For correct plugin work, enable any permalink structure except a plain one.
If you get the message below, the product must already exist.
The message in the error logs means that a product has already been imported to WordPress, and it won’t be processed again.
If the images fail to download, or you come across the following error below, there are steps to resolve this.
This issue occurs during a product/category image import. The issue is environment specific and can be caused by the server itself. Possible reasons for the issue include:
If you repeatedly encounter the same error or warning and this page doesn’t solve your issues, create an Issue in our GitHub repository. Be sure to provide as many details as possible, including the BigCommerce for WordPress plugin version, PHP version, and my SQL version.
Sometimes errors don’t appear in the BigCommerce for WordPress plugin logs, but they can still affect the plugin. If you have exhausted all triaging steps, then it’s suggested that you enable server error logs. Usually, these settings are in your server’s control panel or admin dashboard.