FAIR

Federated and Independent Repositories

Discover, trust, install: FAIR 1.0 is here

Plugin Banner

WooCommerce Square

by WooCommerce

Version: 5.1.0

Download
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®, Google Pay, WooCommerce Subscriptions and 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.

You can download an older version of this gateway for older versions of WooCommerce from here.

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.

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.

  1. The main plugin settings.

    The main plugin settings.

  2. The payment gateway settings.

    The payment gateway settings.

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.

Where can I get support or talk to other users?

If you get stuck, you can ask for help in the Plugin Forum.

Seems to work well

By Peter M. (inveress) on September 15, 2025

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.

So Many Issues

By Anonymous User (anonymized_23173868) on May 1, 2025

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.

works well (10k+ item sync)

By mjb502 on March 20, 2025

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.

Works fine

By stewartlab on August 26, 2024

Dont have any issues and have processed over $500k in online orders. Only online sales and dont use sync so cant comment on that.

what happend?

By sandyc1115 on June 16, 2024

im missing sales due to i dont know what. if it aint broke, dont fix it!

Epic Failure

By daphnetalbot on June 6, 2024

Everything was great until the next day. Twenty hours after installation, the media gallery showed over 700 copies of the wc-square-gift-card-placeholder.png and growing. It was multiplying like bunnies. A support ticket to Automatic got a few responses. Once they mentioned that this was a known bug and they would make a note of it, they stopped answering emails. Upon some digging, this "bug" has been "known" for quite a while. They should pull this plugin off until it is fixed.

Very Helpful Support Team

By brian@foxxr.com on April 18, 2024

The plugin works as promised, and I appreciate how the support team has been dedicated in helping me resolve the issue we were facing. Kudos to the team!

How did this reach production? An Abysmal Failure in Integration

By smgdarien on April 12, 2024

A Masterclass in Frustration

Adding to the already detailed negative review, here’s a compilation of further criticisms based on widespread feedback from other users across various platforms:

Square for WooCommerce Review: A Masterclass in Frustration

The Square for WooCommerce plugin is not just a disappointment; it's an outright failure in modern e-commerce solutions. This integration supposedly designed to simplify the management of online and physical stores instead multiplies the workload and exasperates its users.

Many users echo the sentiment that this plugin remains perpetually in a beta state, never fully delivering on its promises. Retailers find themselves trapped in a vicious cycle of managing dual inventories manually due to the plugin's inability to selectively sync products. If you have more than a handful of products or operate multiple locations, this plugin becomes a hinderance rather than a help.

A common grievance among the users is the plugin’s poor handling of product images and descriptions, requiring store owners to update each platform individually—defeating the purpose of an integration meant to save time. This issue is compounded by the plugin's notorious single-image limitation, which necessitates additional uploads for every product, an archaic feature that users find bewildering in the age of multi-media online retail.

The lack of integration for Square Loyalty is another sore point. Customers cannot view or redeem their loyalty points on WooCommerce, creating a disjointed experience that undermines customer retention strategies and complicates marketing efforts.

The handling of taxes is particularly problematic. The plugin's inability to manage inclusive tax options properly has led to incorrect charges at checkout, infuriating customers and complicating financial reporting for businesses. This issue is especially critical in regions with stringent tax compliance regulations.

Support—or the lack thereof—has been a major point of contention. User forums and review sites are awash with complaints about the non-responsive and unhelpful support team, which often resorts to generic responses. The overwhelming feeling is one of abandonment, with users feeling left to fend for themselves amidst a sea of unresolved issues and unaddressed bugs.

Perhaps the most damning feedback comes from the long wait times for essential updates. The glacial pace at which improvements are made, if ever, suggests a lack of commitment from the developers. The addition of Gift Cards, a basic feature that took over eight years to implement, is frequently cited as emblematic of the plugin’s slow and unresponsive development cycle.

In sum, the Square for WooCommerce plugin is widely regarded as a liability rather than an asset. The litany of unresolved issues, combined with sluggish updates and ineffective support, has led many users to seek alternatives. As a solution partner and retailer, the consensus is clear: this plugin is unfit for serious e-commerce and should be avoided by any retailer who values efficiency, reliability, and customer satisfaction.

Broke my site

By Lee (icrashrcfoam) on April 4, 2024

I've had just about every issue mentioned in the negative reviews. I was able to work through most of them. A lot of the issues people had were due to the poor documentation from Square.
Except for one issue. About 15% of my the items on my site got set to quantity 0. And this happened right before an event. This is absolutely terrible. I'll be removing this from my website after the event is over and never use square again.

Great WooCommerce POS Solution!

By kenjimcauliffe on March 17, 2024

Don't let the negative reviews discourage you from at least giving this plugin a try! Speaking only from my own experience, I find the product synchronisation between Square and WooCommerce to be more reliable and intuitive than I had been led to believe, and I'm very pleased with the plugin.

My one request is the addition of the ability to pay via Square Gift Cards in the block based checkout, as this is currently preventing me from using the block checkout on a couple sites.

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.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.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.
  • 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.

4.8.7 – 2025-03-06

  • Add – Support for syncing the “Mark as Sold Out” field value during inventory sync.
  • Fix – Ensure payment methods display the correct buttons and statuses in the new WooCommerce Payments settings.
  • Fix – Ensure that Cash App Pay works as expected on mobile devices.
  • Fix – Ensure that no blank order is created via the “Add Payment Method” when HPOS is enabled.
  • Dev – Disabled warning checks from WordPress Plugin Check Action.

4.8.6 – 2025-02-10

  • Fix – Resolved “translation loading was triggered too early” issue in WordPress 6.7.
  • Fix – Refresh brand assets.
  • Dev – Bump WooCommerce “tested up to” version 9.7.
  • Dev – Bump WooCommerce minimum supported version to 9.5.
  • Dev – Bump WordPress minimum supported version to 6.6.
  • Dev – Add the WordPress Plugin Check GitHub Action.

4.8.5 – 2025-01-20

  • Fix – Unblock the Checkout page UI, and show a generic error when buyer verification fails.
  • Fix – Ensure inventory sync works correctly for variable products when Square sync is enabled through quick or bulk edit.
  • Dev – Bump WooCommerce “tested up to” version 9.6.
  • Dev – Bump WooCommerce minimum supported version to 9.4.
  • Dev – Use the @woocommerce/e2e-utils-playwright NPM package for E2E tests.
  • Dev – Updates GitHub actions/cache, actions/upload and actions/download to v4 due to deprecation.

4.8.4 – 2024-12-09

  • Fix – Resolved the product duplication issue on the Square side when WooCommerce is set as the SOR.
  • Fix – Remove woocommerce_loop_add_to_cart_link filter to standardize “Buy Gift Card” and “Add to Cart” button styles across themes.
  • Fix – Reposition payment error messages close to Payment Method form on the Classic Checkout page.
  • Dev – Bump WooCommerce “tested up to” version 9.5.
  • Dev – Bump WooCommerce minimum supported version to 9.3.
  • Dev – Group E2E tests using tags and run each group in parallel within the GitHub Actions workflow.
  • Dev – Resolved some failing E2E tests.

4.8.3 – 2024-11-11

  • Fix – Ensure Square sync works without issues when using cached API responses.
  • Fix – Avoid a potential infinite loop during inventory pull.
  • Tweak – Change the maximum object retrieval limit from 100 to 50 to avoid timeout issues.
  • Dev – Bump WordPress “tested up to” version 6.7.
  • Dev – Bump WordPress minimum supported version to 6.5.

4.8.2 – 2024-10-14

  • Add – Title, Description, and Gateway ID props to the express payment method.
  • Dev – Bump WooCommerce “tested up to” version 9.4.
  • Dev – Bump WooCommerce minimum supported version to 9.2.
  • Dev – Bump WordPress minimum supported version to 6.5.

4.8.1 – 2024-09-23

  • Fix – Confirmation popup no longer appears when saving the Square settings.
  • Fix – Connection settings now persist previous connection when toggling between Production and Sandbox.
  • Fix – Prevent gift card image from being forced upon a site.
  • Fix – Update URL linking to Square Developer dashboard in sandbox settings.
  • Dev – Bump WooCommerce “tested up to” version 9.3.
  • Dev – Bump WooCommerce minimum supported version to 9.1.

4.8.0 – 2024-09-16

  • Add – Support for the WooCommerce Product Block Editor.
  • Fix – Address a potential infinite loop issue with the pull_inventory step when running a manual synchronization.
  • Fix – Cancelling Google Pay on checkout shows validation errors.
  • Fix – Missing gift card order item meta during re-order.
  • Fix – Ensure we don’t hardcode the database prefix in queries we run.
  • Fix – Replace the use of deprecated hook wcs_renewal_order_meta with wc_subscriptions_renewal_order_data.
  • Update – Change the business location button text based on the location count.
  • Dev – Bump WooCommerce “tested up to” version 9.2.
  • Dev – Bump WooCommerce minimum supported version to 9.0.

4.7.3 – 2024-08-19

  • Fix – Inconsistency in the height of Express Payment Button and compliance with the new Woo Express Payment Method Styling API.
  • Fix – Ensure the “Uncaught TypeError” JavaScript console error does not occur for out-of-stock products.
  • Fix – Ensure compatibility with WooPayments extension.
  • Dev – Bump WooCommerce “tested up to” version 9.1.
  • Dev – Bump WooCommerce minimum supported version to 8.9.
  • Dev – Update NPM packages and node version to v20 to modernize developer experience.

4.7.2 – 2024-07-29

  • Fix – Check if dependencies are loaded before showing onboarding process.
  • Fix – Ensure the product category syncs properly between the Square and WooCommerce store.
  • Dev – Fix QIT E2E tests and add support for a few new test types.

4.7.1 – 2024-07-22

  • Fix – Remove double encoding from the redirect_url param in the oauth connect url.
  • Dev – Bump WordPress “tested up to” version 6.6.

4.7.0 – 2024-06-27

  • Add – New Merchant Onboarding experience with a new wizard flow & settings pages.
  • Add – Support for WooCommerce Product Blocks.
  • Dev – Bump WooCommerce “tested up to” version 9.0.
  • Dev – Bump WooCommerce minimum supported version to 8.8.
  • Dev – Bump WordPress minimum supported version to 6.4.

4.6.3 – 2024-06-17

  • Add – ESLint GitHub Action workflow to enforce ESLint rules on pull requests.
  • Dev – Bump Square PHP SDK version from 29.0.0.20230720 to 35.1.0.20240320.
  • Dev – Improved codebase by addressing PHPCS errors.
  • Dev – Improved codebase by resolving issues reported by ESLint.
  • Dev – Address QIT PHPStan test errors.
  • Dev – Address QIT Security test errors.
  • Fix – A fatal error could occur when running incompatible versions of WooCommerce.
  • Fix – Apple Pay button is now available on Cart and Checkout Block pages.
  • Fix – Ensure that the ‘Sync stock from Square’ and ‘Sync inventory’ links work properly on the edit product screen.
  • Fix – Prevent cancelled Digital Wallet payments from blocking the Checkout form.

View historical changelog details here.

  • Version:Version: 5.1.0
  • Active installs:Active installs: 80K
  • Last updated:Last updated: 5 days ago
  • Requires:Requires: 6.7
  • Tested:Tested: 6.8.2
Average rating:2.1 out of 5 stars.
  • Number of ratings: 26 ratings
  • Number of ratings: 2 ratings
  • Number of ratings: 6 ratings
  • Number of ratings: 3 ratings
  • Number of ratings: 81 ratings
Back to top