Multi-site Setup
When connecting more than one WordPress site to your BigCommerce store, you need to use an API account to link them. If you try to connect using the 'connect your store' flow, which uses a BigCommerce app to streamline the connection, your first WordPress site will lose its connection to BigCommerce.
Multi-site and subdirectories
Multiple sites can share the same API credentials, or you can choose to create a new set of credentials for each site.
Configuration Method | Is Supported |
---|---|
Subdirectories | No |
Subdomains | Yes |
Separate Domains | Yes* |
Note that embedded checkout is only supported on a single domain at a time. See the BigCommerce for WordPress (opens in a new tab) documentation.*
Getting your API credentials
- To get your store’s API credentials, sign in to your active MSF-enabled BigCommerce store and head to Settings > API > API accounts.
- Click the blue
Create API Account
button on the top left-hand side. This opens up a screen that will ask you to enter a name and select scopes for the API account.
- For the OAuth Scopes, select the following default settings:
OAuth Scope | Default Selection |
---|---|
Content | None |
Checkout content | None |
Customers | Modify |
Customers login | Login |
Information & settings | Modify |
Marketing | Read-Only |
Orders | Read-Only |
Order transactions | Read-Only |
Create payments | None |
Get payment methods | Read-Only |
Stored payment instruments | None |
Products | Read-Only |
Themes | None |
Carts | Modify |
Checkouts | Modify |
Sites & routes | Modify |
Channel settings | Modify |
Channel listings | Modify |
Storefront API tokens | None |
Storefront API customer impersonation tokens | None |
Store logs | None |
Store inventory | None |
- After you have finished setting a name and selecting scopes, click
Save
. You will then see a modal that contains theClient ID
,Client Secret
andAccess Token
necessary for the remaining fields in the WordPress API Credentials settings.
Setting up a WordPress site using API account credentials
- To set up a WordPress site using this method, click
Enter your API credentials
on the welcome screen in the plugin.
- Enter your API credentials on your WordPress site.
Saving the API credentials on your WordPress site will direct you to name the channel that the plugin will create. This allows you to list product to the channel from within BigCommerce and link orders back to the channel that comes from the WordPress site. You can also link to an existing channel.
Congratulations, you're done setting up your additional site!