Title: WooCommerce Square
Author: WooCommerce
Published: <strong>January 29, 2018</strong>
Last modified: April 6, 2026

---

Search plugins

![](https://ps.w.org/woocommerce-square/assets/banner-772x250.png?rev=3234354)

![](https://ps.w.org/woocommerce-square/assets/icon-256x256.png?rev=3234354)

# WooCommerce Square

 By [WooCommerce](https://profiles.wordpress.org/woocommerce/)

[Download](https://downloads.wordpress.org/plugin/woocommerce-square.5.3.2.zip)

 * [Details](https://mlt.wordpress.org/plugins/woocommerce-square/#description)
 * [Reviews](https://mlt.wordpress.org/plugins/woocommerce-square/#reviews)
 *  [Installation](https://mlt.wordpress.org/plugins/woocommerce-square/#installation)
 * [Development](https://mlt.wordpress.org/plugins/woocommerce-square/#developers)

 [Support](https://wordpress.org/support/plugin/woocommerce-square/)

## Description

This plugin allows you to securely accept payments, synchronize sales, and seamlessly
manage inventory and product data between WooCommerce and Square POS.

The Square plugin is PCI and SAQ A-level compliant.

#### Accept payments anywhere, anytime

 * The Square plugin extends WooCommerce to allow you to accept payments via Square–
   including support for [Apple Pay®](https://www.apple.com/apple-pay/), [Google Pay](https://www.google.com/payments/solutions/),
   [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/)
   and [WooCommerce Pre-Orders](https://woocommerce.com/products/woocommerce-pre-orders/).
 * Recurring customers can save payment methods and use them at checkout.
 * Customize payment forms with automatic formatting, mobile-friendly options, and
   retina card icons.

#### Manage your business all in one place

Sync your product and inventory information from WooCommerce to Square, or from 
Square to WooCommerce — set everything up once, and whenever you make a sale, your
inventory automatically updates on both platforms.

 * If you sell mainly online, set WooCommerce as your system of record so WooCommerce
   pushes product name, inventory, prices, categories, and images to Square.
 * If you sell in multiple locations and online, set Square as your system of record
   so Square pushes product name, inventory, prices, categories, and images to WooCommerce.

## Screenshots

 * [[
 * The main plugin settings.
 * [[
 * The payment gateway settings.

## Blocks

This plugin provides 3 blocks.

 *   Square stock management field A block to add stock management field to the 
   product editor.
 *   Sync with Square checkbox field A block to add a checkbox to set the sync with
   Square product setting.
 *   Square stock quantity field A block to add stock quantity field to the product
   editor.

## Installation

You can download an [older version of this gateway for older versions of WooCommerce from here](https://wordpress.org/plugins/woocommerce-square/developers/).

#### Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers
itself and you don’t need to leave your web browser. To
 automatically install WooCommerce
Square, log in to your WordPress dashboard, navigate to the Plugins menu, and click**
Add New**.

In the search field type “WooCommerce Square” and click **Search Plugins**. Once
you’ve found our plugin you can install it by clicking **Install Now**, as well 
as view details about it such as the point release, rating, and description.

#### Manual installation

The manual installation method involves downloading our plugin and uploading it 
to your web server via your favorite FTP application. The WordPress codex contains
[instructions on how to do this here](https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).

#### Updating

Automatic updates should work like a charm; as always though, ensure you backup 
your site just in case.

#### Note

If running PHP 8.2+, you may see some deprecation notices being logged. These notices
are known and do not impact any plugin functionality.

## FAQ

### Does this require an SSL certificate?

Yes! An SSL certificate must be installed on your site to use Square.

### Where can I find documentation?

For help setting up and configuring the plugin, please refer to our [user guide](https://woo.com/document/woocommerce-square/).

### Where can I get support or talk to other users?

If you get stuck, you can ask for help in the [Plugin Forum](https://wordpress.org/support/plugin/woocommerce-square/).

## Reviews

![](https://secure.gravatar.com/avatar/a9c0add9e77a7b2422ee3cf3582abb8a90420fd86bc1a0b6f0291e0a94ed9b22?
s=60&d=retro&r=g)

### 󠀁[No Longer Works, Zero Support](https://wordpress.org/support/topic/no-longer-works-zero-support/)󠁿

 [](https://profiles.wordpress.org/casbboy/) April 7, 2026 1 reply

Square’s AI Bot can’t figure this one out. After working fine for months, Square
is giving this error and everything looks fine on both ends.Square Payment Failed(
Status code PAYMENT_SOURCE_NOT_ENABLED_FOR_TARGET: This account has not been enabled
to take payments)

![](https://secure.gravatar.com/avatar/c7630f1b522634ed56251447044bac1af27579adc408b4e4aab754d5e9cd7c99?
s=60&d=retro&r=g)

### 󠀁[Works well, with caveats](https://wordpress.org/support/topic/works-well-with-caveats/)󠁿

 [gasurgaelach](https://profiles.wordpress.org/gasurgaelach/) February 3, 2026 1
reply

I can understand the bad reviews here – this plugin and Square have made some big
mistakes (i.e. releases that break everything), but they have really got their act
together in the last few months. The biggest issue is around how the documentation
is written – it is unclear and really, should be much clearer. The negativity around
the plugin is also based on Square’s loop of customer support – literally, it takes
weeks to get a solution. But, this should not be taken out on this plugin. Always
test, always scope out what you want and then go live. It is a good plugin and does
the job, Square’s own limitations are nothing to do with the plugin itself. Separately,
I always used Woo as the system of record for clients, before moving to Square for
stock. It means being able to do mini stock-takes rather than two huge inventory
stock-takes per year. The takeaway is that this plugin is brilliant and works well.
Its documentation needs to be improved and Square should (by default) test everything
before releasing versions. It cannot do basic things like map attributes and so 
other solutions are needed and Square are slow to improve their own standalone offering.
But it does what it says on the tin, nothing more. Note you will also have to revert
to Woo’s legacy checkout, which does hit conversion, in order to enable the use 
of gift cards. Don’t be too hard on it! :0)

![](https://secure.gravatar.com/avatar/3b96326784d39efec1f95522261b5dfd2e101795fb86b00de5de60f22dfa71af?
s=60&d=retro&r=g)

### 󠀁[Doesn’t work](https://wordpress.org/support/topic/doesnt-work-3267/)󠁿

 [anakinlaroche1977](https://profiles.wordpress.org/anakinlaroche1977/) January 
21, 2026 1 reply

Stuck on “confirm your business location”. Button doesn’t advance and it’s not the
WP or plugin conflicts.

![](https://secure.gravatar.com/avatar/d9d26dc7b3f4cc32829f6d1f2e0cfb8df011f2918858292c6da1efc61817c881?
s=60&d=retro&r=g)

### 󠀁[Seems to work well](https://wordpress.org/support/topic/seems-to-work-well-54/)󠁿

 [Peter M.](https://profiles.wordpress.org/inveress/) September 15, 2025 1 reply

I’ve found this plugin works well in terms of syncing products and changes to products.
I can update SKUs, names, and shipping details in Woo and everything syncs to Square
perfectly. My only wish so far is that I could have an option to hide wallet payment
buttons on single product pages.

![](https://secure.gravatar.com/avatar/9c98735278d673d5240987f06d6211c7ab29a67f9f136d9e131bc348a0eebf10?
s=60&d=retro&r=g)

### 󠀁[So Many Issues](https://wordpress.org/support/topic/so-many-issues-5/)󠁿

 [Anonymous User](https://profiles.wordpress.org/anonymized-23173868/) May 1, 2025
1 reply

Only use this plugin if you want to use it as a payment gateway and nothing more
The sync doesn’t work. The settings section doesn’t even work. The “Hide synced 
products when not found in Square” will not save. Very frustrating. You’d think 
an official WooCommerce plugin would be better.

![](https://secure.gravatar.com/avatar/5de4676250c84170afcd77ea2bd4912fe0be96e9b1da9df78526eeedd6ef403a?
s=60&d=retro&r=g)

### 󠀁[works well (10k+ item sync)](https://wordpress.org/support/topic/works-well-10k-item-sync/)󠁿

 [mjb502](https://profiles.wordpress.org/mjb502/) March 20, 2025 1 reply

NOTE: this review pertains ONLY to the inventory syncing functionality, NOT the 
payment processing functionality. Been using the plugin since early 2024 (1+ yr).
It reliably syncs 10,000+ inventory items. 100s of features? No. Works as advertised?
Yes. I haven’t had a need to contact support, but will update review if/when. Good
stuff.

 [ Read all 121 reviews ](https://wordpress.org/support/plugin/woocommerce-square/reviews/)

## Contributors & Developers

“WooCommerce Square” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ WooCommerce ](https://profiles.wordpress.org/woocommerce/)
 *   [ Automattic ](https://profiles.wordpress.org/automattic/)

“WooCommerce Square” has been translated into 5 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/woocommerce-square/contributors)
for their contributions.

[Translate “WooCommerce Square” into your language.](https://translate.wordpress.org/projects/wp-plugins/woocommerce-square)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/woocommerce-square/),
check out the [SVN repository](https://plugins.svn.wordpress.org/woocommerce-square/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/woocommerce-square/)
by [RSS](https://plugins.trac.wordpress.org/log/woocommerce-square/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 5.3.2 – 2026-04-06

 * Fix – Prevent stale Square catalog IDs from breaking checkout while still surfacing
   genuine coupon redemption failures as checkout errors.
 * Fix – Ensure that the order note wordings for partial payments are translatable.
 * Dev – Replace deprecated `wc_enqueue_js` with `wp_add_inline_script`.
 * Dev – Bump WordPress “Tested up to” to 7.0.
 * Dev – Bump WordPress minimum supported to 6.8.
 * Dev – Bump WooCommerce minimum supported version to 10.4.

#### 5.3.1 – 2026-03-26

 * Fix – Improved reliability when customers change or remove an applied gift card
   at checkout.
 * Fix – Improved authorization handling for order-related requests in the payment
   flow.
 * Dev – Bump WooCommerce “tested up to” version 10.6.

#### 5.3.0 – 2026-03-05

 * Add – Initial support for Square Discount Codes (Coupons).
 * Fix – Set the “Synced with Square” taxonomy to private.
 * Fix – Ensure that there is no `DivisionByZeroError` fatal error in Square when
   the total amount is zero and the tax amount is non-zero.
 * Fix – Partial-Total Verification when Gift Card is used.
 * Fix – Improved data access restrictions on payment method page.
 * Dev – Bump WooCommerce “tested up to” version 10.5.
 * Dev – Bump WooCommerce minimum supported version to 10.3.

#### 5.2.0 – 2026-01-15

 * Add – A notice for the inventory sync in bulk edit screen.
 * Add – Helper text and notices to clarify the difference between “Sync Now” and“
   Import all Products from Square”.
 * Fix – Ensure that the order is not marked as ‘On Hold’ when saving the card fails
   after a successful payment.
 * Fix – Prevent fatal errors occurring on incompatible environments.
 * Fix – Ensure default titles are displayed for payment methods if not set by the
   merchant.
 * Fix – Prevent images being updated from square when the “Enable to override Product
   images from Square” setting is turned off.
 * Fix – Improve sync settings language for better clarity.
 * Fix – CSV-imported products from Square with inventory tracking disabled are 
   now correctly imported as “In Stock” instead of “Out of Stock” with stock management
   enabled.
 * Fix – Resolve fatal errors that may occur after a server migration.
 * Dev – Update `apimatic/unirest-php` package to 4.0.7.
 * Dev – Bump WooCommerce minimum supported version to 10.2.
 * Dev – Bump WordPress minimum supported version to 6.7.
 * Dev – Error logging when gift card application fails due to missing session token
   or Square API errors.
 * Dev – Remove application of E2E status labels from GitHub actions.

#### 5.1.2 – 2025-12-10

 * Security – Resolve CVE-2025-13457.
 * Dev – Bump WooCommerce “tested up to” version 10.4.
 * Dev – Bump WordPress “tested up to” version 6.9.

#### 5.1.1 – 2025-11-03

 * Fix – Missing attribute names after Product Import.
 * Fix – Update for PHP 8.4 compatibility.
 * Dev – Bump WooCommerce “tested up to” version 10.3.
 * Dev – Bump WooCommerce minimum supported version to 10.1.
 * Dev – Updates to our QIT GitHub Action workflow.
 * Dev – Add new deploy workflow.

#### 5.1.0 – 2025-09-29

 * Add – Support for multiple categories in WooCommerce-Square product synchronization.
 * Add – Improve debugging with more options and verbose descriptions.
 * Fix – Sync only the utilized option values.
 * Fix – Fatal error when using partial product quantities.
 * Fix – Ensure the outline is properly visible when the Google Pay button is focused.
 * Fix – Ensure users are warned that clicking “Buy with GPay” opens in a new window.
 * Dev – Bump WooCommerce “tested up to” version 10.2.
 * Dev – Bump WooCommerce minimum supported version to 10.0.

#### 5.0.1 – 2025-12-10

 * Security – Resolve CVE-2025-13457 for version 5.0.

#### 5.0.0 – 2025-09-10

 * Add – Order fulfillment sync between WooCommerce and Square orders for those 
   that opt-in.
 * Fix – Ensure inventory sync isn’t interrupted in case of a category insert failure.
 * Fix – Accurately count attribute values – 250 values, not characters.

#### 4.9.9 – 2025-12-10

 * Security – Resolve CVE-2025-13457 for version 4.9.

#### 4.9.8 – 2025-08-21

 * Fix – Ensure there is no fatal error on the product page when the product price
   is blank.
 * Fix – Corrected variation option assignment logic to prevent mismatched item 
   option IDs during manual syncs to Square.
 * Fix – Prevent mixing Production tokens when in Sandbox mode.
 * Fix – Vertical spacing on “Enable Payment Methods” step.
 * Dev – Bump WooCommerce “tested up to” version 10.1.
 * Dev – Bump WooCommerce minimum supported version to 9.9.
 * Dev – Bump WordPress minimum supported version to 6.7.
 * Dev – Update vulnerable NPM packages.
 * Dev – Remove loading translations, as it is automatically handled by WordPress
   since version 4.6.

#### 4.9.7 – 2025-07-28

 * Fix – Resolve `CARD_DECLINED_VERIFICATION_REQUIRED` error for 3DS-required credit
   card payments.
 * Fix – Unblock UI and show a generic error when buyer verification fails.
 * Dev – Update NPM packages with security issues.

#### 4.9.6 – 2025-07-10

 * Add – When importing products from Square, a new “View Progress” link on the “
   Update” page allows ability to more closely monitor that progress.
 * Fix – Ensure that Digital Wallet payment methods and Cash App Pay function properly
   in Block Checkout when using Safari.
 * Fix – Prevent the “Sync with Square” setting from getting unchecked.

#### 4.9.5 – 2025-06-30

 * Fix – Ensure the customer is created on the Square side without errors when adding
   a payment method.
 * Fix – Ensure that the request body is correctly logged in the debug logs.
 * Dev – Bump WooCommerce “tested up to” version 10.0.
 * Dev – Bump WooCommerce minimum supported version to 9.8.

#### 4.9.4 – 2025-06-13

 * Fix – Ensure no fatal error occurs at checkout when using a free local pickup
   shipping method.

#### 4.9.3 – 2025-06-09

 * Add – Support for Square’s EMV 3-D Secure authentication flow to comply with 
   countries that have 3DS mandates and improve payment security.
 * Add – Pre-sync validations for Product Variations.
 * Add – Digit handling for country-specific currencies to prevent incorrect division
   by 100 for currencies like Japanese Yen.
 * Add – Indicate customer initiated payments in Square API requests.
 * Fix – Only sync attributes used for variations to Square, preventing item option
   mismatch errors when WooCommerce products have unused attributes.
 * Fix – Ensure consistent error messages between the Block Checkout and the Shortcode
   Checkout.
 * Dev – Bump Square PHP SDK version from `35.1.0.20240320` to `40.0.0.20250123`.

#### 4.9.2 – 2025-05-27

 * Dev – Bump WooCommerce “tested up to” version 9.9.
 * Dev – Bump WooCommerce minimum supported version to 9.7.

#### 4.9.1 – 2025-05-05

 * Add – Set the onboarding URL for the “Complete setup” button on the new payment
   settings page.
 * Change – Remove the `wc_square_update_product_set_variation_name` filter.
 * Fix – Issue with Product Price override update logic.
 * Fix – Show detailed error messages on Checkout Page based on Debug Mode settings.
 * Fix – Ensure that debug logs for payment gateways are being generated as expected.
 * Dev – Add in performance logging during the checkout process.
 * Dev – Update E2E tests to accommodate payment modernization changes in WooCommerce
   Core.

#### 4.9.0 – 2025-04-07

 * Add – Support for syncing multiple Product Variations.
 * Add – Support for WooCommerce’s new Email Improvements feature.
 * Fix – Digital Wallets and Cash App payment issues in Woo 9.8.
 * Fix – Deprecated PHP error for Gift Cards.
 * Fix – jQuery error on Cart & Checkout pages when a Subscription product is added
   to the cart, as Digital Wallets cannot be used for Subscription products.
 * Fix – Remove duplicate onboarding notice.
 * Dev – Bump WooCommerce “tested up to” version 9.8.
 * Dev – Bump WooCommerce minimum supported version to 9.6.
 * Dev – Bump WordPress minimum supported version to 6.6.
 * Dev – Bump WordPress “tested up to” version 6.8.
 * Dev – Updates to E2E tests setup.
 * Dev – Update all third-party actions our workflows rely on to use versions based
   on specific commit hashes.

[View historical changelog details here](https://github.com/woocommerce/woocommerce-square/blob/trunk/changelog.txt).

## Meta

 *  Version **5.3.2**
 *  Last updated **2 weeks ago**
 *  Active installations **80,000+**
 *  WordPress version ** 6.8 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/woocommerce-square/), [English (Australia)](https://en-au.wordpress.org/plugins/woocommerce-square/),
   [English (US)](https://wordpress.org/plugins/woocommerce-square/), [Japanese](https://ja.wordpress.org/plugins/woocommerce-square/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/woocommerce-square/), and 
   [Spanish (Spain)](https://es.wordpress.org/plugins/woocommerce-square/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/woocommerce-square)
 * Tags
 * [credit card](https://mlt.wordpress.org/plugins/tags/credit-card/)[inventory sync](https://mlt.wordpress.org/plugins/tags/inventory-sync/)
   [square](https://mlt.wordpress.org/plugins/tags/square/)[woocommerce](https://mlt.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://mlt.wordpress.org/plugins/woocommerce-square/advanced/)

## Ratings

 2.1 out of 5 stars.

 *  [  26 5-star reviews     ](https://wordpress.org/support/plugin/woocommerce-square/reviews/?filter=5)
 *  [  3 4-star reviews     ](https://wordpress.org/support/plugin/woocommerce-square/reviews/?filter=4)
 *  [  6 3-star reviews     ](https://wordpress.org/support/plugin/woocommerce-square/reviews/?filter=3)
 *  [  3 2-star reviews     ](https://wordpress.org/support/plugin/woocommerce-square/reviews/?filter=2)
 *  [  83 1-star reviews     ](https://wordpress.org/support/plugin/woocommerce-square/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/woocommerce-square/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/woocommerce-square/reviews/)

## Contributors

 *   [ WooCommerce ](https://profiles.wordpress.org/woocommerce/)
 *   [ Automattic ](https://profiles.wordpress.org/automattic/)

## Support

Issues resolved in last two months:

     11 out of 14

 [View support forum](https://wordpress.org/support/plugin/woocommerce-square/)