SquareSync for Woo
Docs
Metafields & Attributes

Metafields & Attributes

Sync Square Custom Attributes to WooCommerce metafields for extended product data.

Square Custom Attributes allow you to store additional product information beyond standard fields. SquareSync can sync these attributes to WooCommerce metafields automatically.

Overview

With metafield syncing enabled:

  • Square Custom Attributes import as WooCommerce metafields
  • Extended product data stays synchronized
  • Map Square attributes to existing WooCommerce metafields
  • No manual data entry required

Enable Metafield Syncing

When importing products, include metafields in your sync:

  1. Go to SquareSync for Woo > Products
  2. Select the products you want to import
  3. Click Import All
  4. Check the Metafields option in import settings
  5. Run the import

Square Custom Attributes will automatically sync to WooCommerce metafields with matching keys.

Metafield Mapping

For more control, map Square attributes to specific WooCommerce metafields:

Step 1: Access Mapping Settings

  1. Go to SWS Pro > Settings > Products
  2. Scroll to the Metafield Mapping section

Step 2: Configure Mappings

  1. Enter the Square attribute key in the left field
  2. Enter the WooCommerce metafield key in the right field
  3. Add additional mappings as needed
  4. Click Save Changes

Example Mappings

Square AttributeWooCommerce Metafield
manufacturer_manufacturer
material_product_material
warranty_warranty_period

Use Cases

Extended Product Information

Store additional specs like dimensions, materials, or manufacturer details that sync between platforms.

Custom Specifications

Technical products can include detailed specifications that display on product pages via custom themes or plugins.

Inventory Tracking Data

Internal tracking codes, supplier references, or warehouse locations can sync as hidden metafields.

Troubleshooting

Metafields not syncing

  • Verify Metafields is checked in import options
  • Confirm the product has Custom Attributes in Square
  • Re-import the affected products

Mapping not applying

  • Check that attribute keys match exactly (case-sensitive)
  • Verify mappings are saved in settings
  • Ensure the WooCommerce metafield key is valid

Missing attribute data

  • Review the product in Square Dashboard
  • Confirm Custom Attributes are properly configured
  • Check that attribute values are not empty
ModifiersAuto Create Products