Browse by Topic

Syncing Your Products with Square

Our Square Register POS (point of sale) integration allows you to import Square products into BigCommerce, export BigCommerce products into Square, then utilize automatic two-way stock updates.

Go to Store SetupPoint of Sale to get started.



  • Product Names — Before starting, make sure none of the products already in your BigCommerce store have the same name as the products you're importing from Square. Having products with duplicate names may result in product information coming over in a manner you don't intend.
  • Variation Names — Variation names are required in Square in order to import SKUs into BigCommerce.
  • Currency — Currently our integration works with CAD, EUR, GBP, NZD, AUD, and USD. If you are using a different currency, please visit our Ideas site and request this feature in your currency.
  • Images — Not all image formats supported by BigCommerce are supported by Square. Square recommends JPG/JPEG or PNG format for your images.

How Does it Work?

This integration lets you export products from BigCommerce into Square and import products from Square into BigCommerce.

User-added image

  • Only products that don't already exist in the receiving platform will be created.
  • A maximum of 25,000 SKUs can be transferred between BigCommerce into Square at a time. Stores importing or exporting more than 5,000 SKUs will experience significant delays.
  • When you add a new product (either in BigCommerce or in Square), you'll click the blue Import/Export button to synchronize your BigCommerce and Square catalogs.
  • While the connection is active, stock levels will automatically update in both places.
    • Order-based stock level changes in BigCommerce will update Square's stock levels in real-time.
    • Order-based stock level changes in Square will update BigCommerce's stock levels in real-time.
    • Manually updating stock levels in BigCommerce will update Square's stock levels in real-time.
    • Manually updating stock levels in Square will not update BigCommerce's stock levels.
    • Purchase Orders in Square will not update BigCommerce's stock levels.

The following product details are imported/exported between BigCommerce and Square:

  • Product name
  • Image
  • Description
  • Category (since Square does not support nested categories, only the top-level category will be passed to Square)
  • Price (Cost, MSRP/Retail Price, and Sale Price are not included/synced)
  • Inventory/stock level
  • Options (including stock level and price) - must be associated with SKUs
    • Display Style for options is not a configurable setting in Square, so imported multiple choice options will default to radio button list style. This can be changed post-import if needed.
    • BigCommerce will automatically create a new option set (named after the product) for products with options imported from Square.
  • Rules - must be associated with SKUs

Connecting to Square

1. Go to Store SetupPoint of Sale.

2. Click Get Started.

3. You will be asked to sign in to your Square account. (If you don't have one, you can create one now.) If you have more than one location with Square, you'll be asked to pick which location you want to connect with BigCommerce. Only one location can be linked per Square account. If you need to select another location, you'll need to disconnect your account, then reconnect.

4. Click Continue to allow BigCommerce to access your Square data.

Allowing Square to connect and Continue button

5. Your Square account is now linked to BigCommerce.


Importing and Exporting Your Products

Click Import/Export. You'll be asked whether you want to do an Import (products from Square will be added to BigCommerce) or an Export (products from BigCommerce will be added to Square). Select one, then click Submit to begin the sync.

Square import progress

The import or export will begin. Depending on how many products you have this may take a while. Feel free to navigate away; the process will keep running in the background. When it's done, you'll see a success message along with the number of products that were created and updated.

Square Register in the control panel showing the Active status indicator, import/export button, disconnect link, last import details and issues, and Download CSV File ink.

    • If there were any issues saving any products, you'll see a warning message. Included in the message is a link for Download CSV file that has more detailed information about which products are having issues and what data is needed.
    • If you're importing into BigCommerce from Square, go to ProductsProduct Categories. Check to see if you have a category called Uncategorized Square Items. If so, follow the instructions below.

    Real-time Stock Updates

    Once your products have been imported/exported, the status will change to Active to indicate stock updates between BigCommerce and Square are being processed in real time.

    • If you need to disable stock syncing, click the Disconnect link. This will change the status indicator to Not Connected and will stop real-time stock updates.
    • To re-enable stock syncing, you'll need to import/export your catalog again.

    Categorizing Square Products

    After your import, go to ProductsProduct Categories. You may find a category for Uncategorized Square Items, which contains any products from Square that did not have a category specified. If you have this category, follow the steps below.

    1. Click ActionProducts. This will take you to a view of all of your products in the Uncategorized Square Items category.

    • If you have several products and would prefer to recategorize them with an Import/Export, see Importing and Exporting Products.
    • If you prefer to quickly recategorize them in bulk through the control panel, continue to Step 2.

    2. Select your products by clicking the checkbox at the top left. Click Choose an ActionBulk Edit Selected, then click Confirm. You will be taken to the bulk edit page.

    Bulk Edit selected

    3. Under the Category column, select the product's new category in BigCommerce. Once you’ve made all of your changes, click Save and Exit.

    Bulk Edit Categories

    Recategorizing with Import/Export

    1. From the ActionProducts screen, select all of your products by clicking the checkbox in the top left.

    2. Click Choose an ActionExport These Products, then click Confirm.

    Export these products

    3. Export the products using the Bulk Edit template.

    4. Go through the Category column to recategorize your products. 

    5. Import your revised CSV file. The products will be reassigned to their new categories.


    Disconnecting your Square Account

    If you need to disconnect your Square account from BigCommerce, you can use the Revoke Access link. You may need to click the Disconnect link to disable real-time stock updates first if they're enabled.

    The Revoke Access link will disconnect your Square account from BigCommerce.



    Can I use Square as a payment gateway?

    Yes. If you want to allow your customers to check out using Square Payments, see Connecting the Square Payment Gateway. However, you do not need to be using Square Payments in order to sync your inventory with Square.

    Are Square orders included in my store's GMV and order count?

    No. Orders created via Square do not come into the BigCommerce control panel and that revenue is not counted as part of your store's sales.

    Are UPCs exported?

    No. UPCs will not be exported from BigCommerce into Square (Square does not have a dedicated UPC field).

    Is product tax information imported from Square?

    No. Tax settings must be set up, and any product-level tax information must be added in BigCommerce.

    Was this article helpful?