SQUARE AND WOOCOMMERCE

A Square WooCommerce integration you can actually trust.

A Square WooCommerce integration should mean one count: sell a mug at the counter and the website knows. When the counts keep drifting, the cause is usually the catalog, a setting, or a rule the standard extension cannot express. I find which one, then fix it or build the sync your store needs.

Or call or text (502) 387-1142
5.0 23 Google reviews
25+Years building websites
1Person, start to finish
The Heimerdinger Cutlery website on a desk monitor
The The Island Earth website on a desk monitor
The Cru Bear website on a desk monitor
Recent work · live site
Heimerdinger Cutlery
Visit heimerdingercutlery.com

Websites I have built for Kentucky businesses

  • Kentucky Peerless Distilling logo
  • Heimerdinger Cutlery logo
  • Vendome Copper & Brass Works logo
  • Justin Gooch Law logo
  • Allied Plumbing logo
  • Cardinal Wings Aviation logo
  • HogMatch logo
  • Field of Screams Kentucky logo
  • Lakeside Oasis RV Park logo
  • Legacy Cooperages logo
  • Dr. Stephanie Moore MD logo
  • Old Mill Venue logo
  • Todd Lewis Law logo
  • Lakeside Boat Storage logo
  • The Island Earth logo
  • Aerial Photography Louisville logo
  • Cru Bear logo
  • Arrow Aerial logo
WHY SQUARE SYNC DRIFTS

The official extension works on rules most owners never see.

The official Square extension for WooCommerce matches products by SKU. Every product needs one, and each product has to be opted in to sync. You choose which side is the source of truth, and even when WooCommerce is in charge, the extension pulls stock from Square every hour to pick up counter sales. Variation titles and images do not sync, and variable products have to fit inside Square’s limits of 6 attributes and 250 variations, according to WooCommerce’s own sync documentation.

None of that is wrong, but it means a missing SKU, a product assigned to the wrong location or a server that never runs background jobs will quietly break the count. And when it breaks, a Square employee on Square’s own seller forum told an owner in 2021 that the integration is built and managed by WooCommerce, so you can end up passed between two help desks. That is the gap a POS integration developer fills.

WHERE IT GOES WRONG

Six reasons a Square WooCommerce integration stops agreeing.

Each of these comes straight from how the extension is documented to work. Most are catalog or setup problems, not bugs.

SKUs

Missing or duplicate SKUs

The SKU is the only thing tying a Square item to a website product. A blank SKU means no sync; a duplicate means the wrong product changes.

Source

The wrong side in charge

With WooCommerce set as the source, its data overwrites Square’s. That is the wrong way round when most stock changes happen at the counter.

Location

Stock counted at another location

Square tracks inventory per item variation at each location. Products tied to the wrong business location sync numbers from the wrong shelf.

Variations

Products Square cannot hold

A variable product over Square’s attribute or variation limits fails validation, and one with no variations does not sync at all.

Server

Background jobs that never run

The extension needs background processing enabled on the server. If the host disables or blocks it, or scheduled tasks are broken, the sync cannot run on schedule.

Timing

An hour is too long

Counter sales reach the website on an hourly pull. For one-of-a-kind items or a busy release, that is long enough to sell something twice.

WHAT I DO ABOUT IT

Three honest options.

Option one

Tune the official extension

Audit SKUs on both sides, set the right source of truth and location, confirm background jobs run, and read the sync records until every product agrees. Often this is all a store needs.

Option two

Build a custom sync

Square sends a notification when an inventory count changes, including when a sale completes at the register. A purpose-built plugin can react to that sale instead of waiting an hour, with your rules about what syncs and what happens at zero.

Option three

Leave it alone

If the counts match and an hour of lag never costs you a sale, the standard extension is the cheaper answer. I will tell you that rather than sell you a rebuild.

THE SAME WORK, IN PRODUCTION

One count between a register and a website, every hour.

The register sync I run in production today is on Clover, at Kentucky Peerless. A custom plugin I wrote reads the distillery gift shop’s register and updates the website’s inventory every hour. It replaced a third-party sync subscription whose quiet mismatches had to be traced SKU by SKU, and doubtful product matches wait for a person to confirm instead of creating duplicates.

Square exposes the same building blocks: a catalog of item variations, inventory counted per location, and notifications when a count changes. The method is the same: audit the catalog, decide the rules, then wire it.

Kentucky Peerless merchandise store, an online catalog kept in step with the distillery's register by a custom sync from Shaun Wilson Designs
HOW IT GETS FIXED

From two counts to one.

01

Compare both catalogs

Square items and website products side by side, before touching a setting. Missing, duplicated and mistyped SKUs get fixed first.

02

Choose the source

Usually the side where most stock changes happen. Decided once, written down, set the same way everywhere.

03

Fix or build on a copy

Settings changes or a custom sync are tested on a staging copy against your real Square data, never on live orders.

04

Watch the first week

Counts are compared by hand for the first days of real selling, then the sync is monitored by the person who set it up.

SQUARE QUESTIONS

Square and WooCommerce, answered.

01

Does Square integrate with WooCommerce?

Yes. The official Square extension for WooCommerce is both a payment gateway and a product and inventory sync. It works well when the catalog is clean and the settings match how you sell.

02

Why is my Square inventory not syncing to WooCommerce?

Check that every product has a SKU that matches Square exactly, that sync is turned on for the product, that it belongs to the right Square location, and that your server runs background jobs. Then read the extension’s sync records for errors.

03

Should Square or WooCommerce be the source of truth?

Usually the side where most stock changes happen. For a shop that sells mostly at the counter, that is Square. For a store that lives online and sells a little in person, WooCommerce may make more sense.

04

How quickly does a counter sale reach the website?

With the official extension, Square stock is pulled hourly. A custom sync can listen for Square’s inventory notifications and update the website when the sale happens.

05

Will a custom sync add another monthly fee?

Not from a middleman. A custom sync is a plugin on your own site, quoted flat from a written scope. Square’s own processing fees still apply as usual.

06

Should I leave Square Online for WooCommerce instead?

Sometimes. If you need rules, content or search pages Square Online cannot give you, WooCommerce with a sync is worth it. I wrote an honest comparison, and I work from Louisville with shops anywhere in the country.

READY WHEN YOU ARE

Tell me where your counts stop agreeing.

Send me your store and a product or two that keeps drifting. I will tell you whether it is a setting, the catalog, or a job for a custom sync.

Connect with me

Tell me about your Square setup.

What happens next

  1. 01
    I reply, usually the same day. Every message comes straight to me, not a ticket queue.
  2. 02
    A short call. What the site needs to do, who it is for, and what has not worked before.
  3. 03
    A written scope and flat quote. Before any work starts, with hosting and ongoing care listed separately.
Rather talk?(502) 387-1142shaun@shaunwilsondesigns.comMon to Fri, 8am to 6pm

5.0 on Google · 23 reviews · I usually reply the same day