BigCommerce for Wordpress

Plugin Settings

BigCommerce settings for WordPress are found in the left admin menu in WordPress, under the BigCommerce menu item.

Plugin Settings
Plugin Settings

API Keys

To connect with your BigCommerce account, you first must create an API Account. To create an API account, visit the API Accounts page under Advanced Settings in your BigCommerce store admin.

API Keys
API Keys

Click the “Create API Account” button at the top of the page to create a new account. Give your API keys a name, it can be anything. Then set all of the OAuth Scopes to “Modify”. (Currently “Content”, “Marketing”, and “Themes” permissions are not used, but they may be added to the plugin in the future. Then click the Save button. You will be asked to save a text file with contents similar to this:

ACCESS TOKEN: jm5eqx5gte9tdzuip4hsnxqc7tq0ruh
CLIENT ID: 6lth4chwzeww8io49mxz69acs55dg89
CLIENT SECRET: 18146epslacfteu7kld2qr1ya5sxxsf
NAME: My Store API Keys

In addition to this text file the information will also be presented on your screen.

Keep Your Credentials

There is no way to re-display this pop-up after you select Done to dismiss it.

Make sure you store your credentials – either by copying/pasting the contents of each field out of the pop-up, or by keeping the downloaded .txt file. Otherwise, you will need to repeat all the above steps to generate new credentials.

Product Sync

Once your API credentials are validated, the plugin will import products using the BigCommerce API. This will run automatically using WordPress cron, using the schedule set on the settings page (default: every five minutes). If you choose to disable the cron job, you can set a server-side cron job to run the sync using WP-CLI. The command to import products is:

wp bigcommerce import products

Product descriptions can be edited in the WordPress admin. The “Do not update products on import” setting should remain checked to preserve these edits. If it is unchecked, those edits will be overwritten with data from the API on the next import. No matter the value of the checkbox, other product details (e.g., prices, availability, categories) will always be synchronized.

Cart Settings

When the cart is enabled, visitors to your store can add products to carts before checkout. If it is disabled, the “Add to Cart” button becomes a “Buy Now” button, sending customers directly to checkout for that product. When the cart is enabled, the plugin will automatically created a page to host the cart shortcode, [bigcommerce_cart]. This shortcode will show the current visitor’s cart. To change this to a different page, first create a page with the cart shortcode, then come back to the settings page and select it from the dropdown. Note: this page may have been created automatically by the plugin.

Currency Settings

The store’s currency code will be imported from the BigCommerce API as part of the product import process. If the PHP intl extension is available on your server, there is nothing else to configure. If it is not available, you will be presented with additional fields to control currency formatting. These will also be populated automatically from the API. Currency formatting can be filtered using the bigcommerce/currency/format filter.

Accounts and Registration

User accounts in WordPress will be connected to customers in BigCommerce. If user registration is enabled in WordPress (the “Anyone can register” checkbox at Settings -> General in the WordPress admin), customers will be able to register accounts and manage their profiles. The plugin requires several pages to support user account management. These pages will all be created automatically. Each will contain a shortcode that renders the relevant content. If any are deleted, they will be automatically re-created for you. If you have multiple pages with these shortcodes, you may select which will be treated as canonical using the dropdowns in this settings section. The “Support Email” field will be used to give customers an address to contact you with questions about orders.

The cart page should be excluded from any page caching system enabled for your site.

Theme Customizer

The visual presentation of your store can be customized using the WordPress theme customizer. Open the theme customizer and find the “BigCommerce” panel, which contains several sections.

Buttons: Control the labels applied to buttons for interacting with products.
Colors & Themes: Customize colors to better match your theme.
Catalog Pages: Control the presentation of lists of products.
Product Single: Control the presentation of individual product pages.
Product Archive: Customize labels and filters for the prouct archive.

Navigation Menus

This plugin creates several pages, and they can be added to the WordPress navigation menus using the standard WordPress admin (Appearance -> Menus, or in the theme customizer). Some of these pages acquire special functionality when they are added to navigation menus: Cart: The cart menu item will show the number of items in the current user’s cart.
Login: If the user is logged in, the login page menu item becomes a link to log out.
Register: If user registration is disabled, the menu item will be disabled (it won’t render on the front end of the site). If the user is logged in, the menu item will link to the user’s account profile.
Account Profile, Order History, Addresses: If the user is not logged in, these menu items will be disabled (they won’t render on the front end of the site).


Reviews left on the WordPress store are sync’d back to BigCommerce for permanent storage as well as usage on other channels. Additionally, they’re store in a local, custom database for quick access.

Whether reviews are active or not is determined by the site’s Comments setting, under Settings → Discussion in the WordPress admin. Additionally, each product has a Comments switch which can be used to override the global settings.

Gift Certificate Settings

If this checkbox is enabled then people will be able to purchase gift certificates from the site. This will also require that two pages be created with the proper shortcodes on them. Gift Certificate Page This page has probably already been created by the plugin, but if not create a plain page with whatever title you’d like, and make sure this shortcode is in the page content: [bigcommerce_gift_form]

This is the page where customers will buy their gift certificates.

Gift Certificate Balance Page

This page has probably already been created by the plugin, but if not create a plain page with whatever title you’d like, and make sure this shortcode is in the page content: [bigcommerce_gift_balance]

This is the page where customers will be able to check their gift certificate balance.