Discount Syncing
Sync Square discounts to WooCommerce automatically.
Sync your Square catalog discounts to WooCommerce. When enabled, discounts configured in Square automatically apply at checkout.
Looking for coupon codes (codes customers type in at checkout or the register)? That's a separate feature — see Discount Codes (Beta).
Enable Discount Syncing
- Go to SWS Pro > Settings > Products
- Find the Discounts section
- Toggle on Enable Discount Syncing
- Click Save Changes
Supported Discount Types
SquareSync supports the following discount types from Square:
| Type | Description |
|---|---|
| Fixed Percentage | Percentage-based discounts (e.g., 10% off) |
| Fixed Amount | Fixed dollar amount discounts (e.g., $5 off) |
Application Scopes
| Scope | Behavior |
|---|---|
| Whole Purchase | Applied to entire cart (only the highest-value discount applies) |
| Line Item | Applied to specific products or categories |
What Gets Synced
Square catalog discounts with valid pricing rules sync to WooCommerce and apply automatically at cart and checkout.
Configuration Options
Global Toggle
Enable or disable real-time discount syncing entirely from the settings page.
Per-Discount Toggles
After enabling, you can manually enable or disable individual Square discounts to control which ones sync to WooCommerce.
Key Behaviors
Whole Purchase Discounts
When multiple whole-purchase discounts could apply, only the best deal is used. The discount with the highest value wins.
Line Item Discounts
Line-item discounts respect the pricing rules configured in Square:
- Quantity minimums (e.g., buy 3 or more)
- Subtotal minimums (e.g., spend $50 or more)
- Product or category targeting
Excluded Items
Since 9.10.7. If a discount rule in Square is configured with excluded items or categories, those exclusions are honoured in WooCommerce too:
- Excluded products and categories are never discounted, in the cart or on product pages
- For whole-purchase percentage discounts, the discount is calculated from the non-excluded portion of the cart only
- If everything in the cart is excluded, the discount is not applied at all
Updating from an earlier version? Open the Discounts page and refresh the discount list once so the exclusions are picked up. Before 9.10.7, exclusions were ignored on the WooCommerce side.
For code-level control — skipping a discount conditionally, or excluding products/categories beyond what's configured in Square — see the sws_apply_square_discount and sws_product_matches_discount filters.
Third-Party Add-On Exclusions
Surcharges from third-party plugins are excluded from discount calculations:
- Product Add-Ons
- Composite Products
- Similar add-on plugins
This prevents discounts from incorrectly applying to customization fees.
Limitations
Discounts are automatically disabled and won't sync when:
- PIN required — Square discounts requiring a PIN cannot sync
- No pricing rules — Discounts must have at least one pricing rule attached
- Expired rules — All pricing rules on the discount have expired
- Loyalty rewards — ATTACHED mode discounts (loyalty program rewards) are excluded to avoid conflicts
- Unsupported types — Only FIXED_PERCENTAGE and FIXED_AMOUNT types are supported
Troubleshooting
Discounts not appearing in WooCommerce
- Verify discount syncing is enabled
- Check the discount has valid pricing rules in Square
- Confirm the discount type is supported
- Review per-discount toggles for the specific discount
Discount not applying at checkout
- Ensure the cart meets any minimum requirements
- Check product/category targeting matches items in cart
- Verify the discount hasn't expired