1. Faire Help Center
  2. Brands
  3. Optimizing shop

WooCommerce Integration with Faire

Menu

    Avatar
    Chat Support
    • Updated
    Follow

    What is the WooCommerce Integration?

    The WooCommerce Integration with Faire will allow you to seamlessly sync information between the two platforms including:

    • Product Import of new products from WooCommerce to Faire
    • Ongoing product syncing to allow them to update information on Faire products such as images, descriptions, etc.
    • Syncing orders from Faire to WooCommerce
    • Syncing inventory between Faire and WooCommerce
    • Syncing fulfillment information from WooCommerce back to Faire

    How do I install the Faire for WooCommerce Plugin?

     Before you begin:

    • You need to have a WooCommerce PHP of 7.4 or higher installed to use this integration.
    • This integration is not compatible if you have WPML installed in WooCommerce.

    To install and connect the plugin:

    1. Go to your Faire Integrations tab and select WooCommerce listed within the Direct integrations section. 
    2. Select Generate API key and choose the Copy API key link to copy and save these details.
    3. Login to your WooCommerce portal.  
    4. From the left menu, navigate to the Plugins tab and select Add New. 
    5. Search for the Faire for WooCommerce plugin. 
    6. Select Install now on the Faire for WooCommerce card, then select Activate to populate this to your Plugins tab. 
    7. Go to the Plugins tab and select the Settings link below the Faire for WooCommerce plugin.
    8. Paste the API key you received from Faire into the API key field.
    9. Set the API Mode to Production. 
    10. Select Save Changes at the bottom of the page to complete the install.

    How do I link my products with WooCommerce? 

    If you are an existing brand on Faire, you’ll need to link your products to ensure proper syncing between WooCommerce and Faire. If you’re new to Faire, and haven’t uploaded products yet, you can skip this step. 

    • Product linking allows you to match existing Faire products to WooCommerce products without having to import them again.
    • It allows order, inventory, and product syncing to happen on a scheduled basis.
    • For product linking to work, all products in Faire and WooCommerce must have a unique SKU associated with the product variants.

    To link products: 

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Go to the Link Faire products section.
    4. Select Link products to begin the linking process. 
    5. After the sync, review the Last link details  to see how many products were linked.

    If you have all the same products and variations on Faire that you do in WooCommerce, and they have the same SKU on them, this will be the only step you need to take to link your products.

    How do I link Faire products that don’t exist in WooCommerce? 

    If you have products listed on Faire that haven’t yet been created in WooCommerce, you can choose to automatically add them, or manually manage them if you have a large catalog. To manage this setting: 

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Choose the Link Faire products tab. 
    4. Choose one of the following options: 
      1. To automatically add products:
        1. Select the checkbox for Yes, add products to WooCommerce.
      2. To turn off automatic creation:
        1. Deselect the checkbox to prevent new Faire products from being added to WooCommerce.
    5. Select Save changes to update your settings.  

    If you have a large number of products create your products manually:

    1. Deselect Yes, add products to WooCommerce.
    2. Select Download product CSV to export your Faire product data.
    3. Use the CSV file to upload and create your products manually in WooCommerce.

    What happens if I have WooCommerce variations that don’t exist on Faire?

    If a product in WooCommerce has variations that aren’t yet listed on Faire such as new sizes, or colors, those variations will be created on Faire during your next product sync after running product linking.

    This applies to new variation values under an existing attribute (ex: adding size “L” to an existing “Size” attribute), not to entirely new product attributes.

    Ex:
    If your WooCommerce product includes sizes S, M, and L, but only S exists on Faire, then after linking and syncing, the M and L sizes will be added to the Faire product.

    If you don’t want those variations on Faire, you can unpublish them from your Products tab on Faire after they sync.

    What happens if I have variations on Faire products that do not exist on WooCommerce? 

    If your Faire product has additional variations that don’t exist in WooCommerce, those missing variations can be created in WooCommerce during the next product sync, after you’ve completed product linking.

    This applies to variation values within an existing attribute, such as adding new sizes to an existing Size attribute.

    Ex:
    If your product on Faire is available in S, M, and L, but your WooCommerce version only includes S, then after linking and syncing, the M and L variations will be added to the WooCommerce product.

    To prevent Faire variations from being added to WooCommerce:

    1. Go to the Plugins tab in WooCommerce.
    2. Select the Settings link under the Faire for WooCommerce plugin.
    3. Choose the Link Faire products tab.
    4. Uncheck the box for Create new variations from Faire.
    5. Select Save changes.

    For large catalogs:

    • Uncheck Yes, add product variations to WooCommerce.
    • Download your Faire product data as a CSV and import variations manually into WooCommerce.

    What should I do if I have unmatched variations in both systems? 

    If you have product variations that exist on Faire but not in WooCommerce, and vice versa, you’ll need to manually add missing variations to link properly between platforms. 

    When you run product linking, the system will alert you if any variations are unmatched and need to be added manually.  

    To add the variation manually in WooCommerce:

    1. Go to the Products tab in your WooCommerce portal. 
    2. Select the product that needs updating. If a manual link is required you’ll see a message indicating this. 
    3. Under the product title, select Edit.
    4. Scroll to the Variations tab and choose Add manually.
    5. Enter the variation details and select Save changes. 

    To complete the linking process: 

    • Expand the newly made variation and enter the correct SKU to match the corresponding variation on Faire. 
    • Return to the Products page, and manually sync the product. 

    Once this sync is complete, missing variations from WooCommerce will be created on Faire. Any products that are deleted will be automatically un-synced and will need to be re-synced manually. 

    How do brand settings sync between Faire and WooCommerce? 

    Your language and currency settings in WooCommerce come from your Faire account. If you update your location or currency in Faire, those changes won’t sync automatically. You’ll need to re-sync them manually.

    To re-sync brand settings:

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link below the Faire for WooCommerce plugin.
    3. In the Faire API and Account, scroll to Shop language and currency. 
    4. Select the sync again link to re-sync the currency or location changes.

    How does product sync mode work? 

    Product sync mode determines whether new products and product updates from WooCommerce are synced to Faire automatically or manually. This setting affects both newly created products and updates to existing products that have already been imported.

    To manage your product sync mode:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync settings section.
    4. Choose one of the following options:
      1. Sync products manually: Products and product updates will not sync automatically. You’ll need to manually trigger syncs for any changes to appear on Faire.
      2. Sync products automatically: New products and updates will sync to Faire on a regular schedule that you define.

    Selecting the right sync mode helps you control how and when your product data is shared between platforms.

    How do I avoid product duplication with my WooCommerce settings? 

    If a product exists on Faire before integrating with WooCommerce, importing it from WooCommerce may create a duplicate. 

    The product needs to be synced from WooCommerce to sync product and order information between the two platforms. To prevent duplicates, you can keep the newly imported product active and deactivate your existing Faire product to allow this integration to work seamlessly for you.

    Deactivating or deleting products removes all the associated sell-through data and analytics for those products. We recommend checking that you are deleting the correct product from Faire, and not the newly created product. 

    How do I set up automatic product syncing? 

    If you’ve turned on automatic product syncing, you can choose how often product updates sync by using the Automatic sync schedule setting. 

    To set your automatic sync schedule:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync settings section.
    4. Under Automatic sync schedule, choose your preferred sync frequency.

    You can select the time increments in which product information will update. The minimum sync frequency is every 0.5 hours (30 minutes).

     

    How do I control whether product updates sync with inventory changes? 

    The Update stock with product sync setting allows you to control whether product details sync during inventory updates from WooCommerce to Faire:

    To manage this setting: 

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync settings section.
    4. Find the Update stock with product sync option and choose one of the following:
      1. Yes (checked): Product updates will sync automatically every time inventory changes.
      2. No (unchecked): Only the inventory will sync. Product details won’t be updated upon inventory changes.

    How is product pricing calculated between WooCommerce and Faire?

    You can set how your product pricing is calculated on Faire based on your pricing setup in WooCommerce. This is managed within the Product sync settings in your WooCommerce portal.

    To configure your pricing settings:

    1. Go to the Plugins tab in WooCommerce.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync settings section.
    4. Under Pricing, choose your WooCommerce pricing model:
      1. If you use retail pricing in WooCommerce:
        1. Enter the wholesale price percentage you want to apply for Faire. This percentage represents the markup taken off your listed retail price to calculate your wholesale price.
          • Minimum allowed: 10%
          • Maximum allowed: 80%
      2. If you use wholesale pricing in WooCommerce:
        1. Enter the retail price multiplier to calculate your Faire retail price.

    Can I exclude certain fields from syncing?

    Yes, you can exclude specific fields so they’re not overwritten on Faire during the product sync. To exclude fields from syncing:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync tab.
    4. Scroll to the Exclude these Faire-specific fields from syncing section.
    5. Use the dropdown menu to select the fields you want to exclude from syncing.

    Ex: If you do an import of a product and the SKU from WooCommerce imports to Faire as 12345, but you would like to change the SKU to faire12345 on Faire, adding the variant sku to the excluded sync fields will ensure we do not overwrite this change during the next product sync.

    Changes made on Faire products will not be carried over to WooCommerce, so there is no risk of that information being overwritten.

    How do I manually sync products on WooCommerce?

    If you don’t have automatic syncing enabled, you can manually sync products at any time using the Sync products now button.

    To manually sync products:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Product sync tab.
    4. Scroll to the Manual product sync section.
    5. Select Sync products now to initiate a manual sync.

    This is especially helpful when you're making real-time updates or if automatic syncing is turned off.

    Where can I see product sync history on WooCommerce?

    You can see your product sync history within the Last sync details section located in the Product sync tab in WooCommerce. 

    This will show you a log of:

    • How many products are queued to sync in the next sync
    • The last product sync that occurred
    • Products successfully synced
    • Any errors that occurred

    What are the order sync options on WooCommerce? 

    You can choose how orders placed on Faire are synced to WooCommerce using the Order sync mode setting.

    To manage your order sync preferences:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Orders and inventory tab.
    4. In the Order sync mode section, choose one of the following options:
      1. Sync orders manually: Orders will not sync automatically. You’ll need to sync them individually as needed.
      2. Sync orders automatically: Orders will sync from Faire to WooCommerce on an ongoing schedule that you define.

    Choosing the right sync option ensures your order flow aligns with how you manage fulfillment in WooCommerce.

    How do I set up automatic order syncing in WooCommerce?

    You can enable automatic syncing to pull in new orders from Faire on a recurring schedule.

    To set up automatic order sync:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Orders and inventory tab.
    4. In the Order sync mode section, select Sync orders automatically.
    5. Under Automatic sync schedule, choose how frequently orders should sync. 
    6. If you want to sync orders starting from a specific date, use the Sync orders since field to set your desired start date.

    The minimum frequency is every 0.5 hours (30 minutes). Setting this up ensures that new Faire orders sync to WooCommerce without needing manual intervention.

    Can I exclude certain Faire orders from syncing in WooCommerce? 

    Yes, you can choose to exclude specific Faire orders from syncing to WooCommerce based on their order status.

    To exclude orders from syncing:

    1. Go to the Plugins tab in your WooCommerce portal.
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Navigate to the Orders and inventory tab.
    4. Scroll to the Exclude from syncing section.
    5. Select the Faire order statuses you want to exclude from syncing to WooCommerce.

    This allows you to filter out draft, canceled, or other order states that you don’t want automatically synced.

    Can Faire orders be created in WooCommerce automatically? 

    You can choose whether orders placed on Faire are also created in WooCommerce. To manage this setting:

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Go to the Orders and inventory tab in your WooCommerce portal.
    4. Find the Create orders automatically section.
    5. Choose one of the following options:
      1. Yes (checked): Orders placed on Faire will automatically be created in WooCommerce. Inventory for those items will also be deducted from WooCommerce.
      2. No (unchecked): Orders will not be created in WooCommerce, but inventory will still be deducted for items sold on Faire.

    How can I sync inventory when a product is added to the WooCommerce cart?

    To prevent overselling, you can enable a setting that triggers an order sync with Faire every time an item is added to a WooCommerce cart.

    To manage this setting:

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Go to the Orders and inventory tab in your WooCommerce portal.
    4. Find the Sync inventory on Add to cart section.
    5. Choose one of the following options:
      1. Yes (checked): A real-time sync will run each time a product is added to a cart in WooCommerce. This checks for any recent orders placed on Faire that might affect available inventory.
      2. No (unchecked): Inventory syncs will follow your set Order Sync Mode schedule instead of syncing in real time.

    This setting helps you keep your inventory up to date across both platforms and avoid overselling.

    How can I manually sync orders from Faire to WooCommerce?

    If you don’t have automatic order syncing enabled, you can manually sync orders at any time.

    To do this:

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Go to the Orders and inventory tab in your WooCommerce portal.
    4. Scroll to the Manual order sync section.
    5. Select the Sync orders now button.

    This is useful if you want to pull in the latest Faire orders without waiting for your next scheduled sync.

    How can I view my last sync details in WooCommerce?

    You can view a log of recent sync activity directly in your WooCommerce portal. To access this:

    1. Go to the Plugins tab in your WooCommerce portal. 
    2. Select the Settings link beneath the Faire for WooCommerce plugin.
    3. Go to the Orders and inventory tab in your WooCommerce portal.
    4. Scroll to the Last sync details section.

    This section will show you:

    • The time of the most recent product sync
    • The number of orders queued for the next sync
    • A count of successfully synced orders
    • Any sync errors that occurred

    Reviewing this log can help you monitor sync activity and troubleshoot issues as needed.

    What Faire specific product fields are added to WooCommerce? 

    Your WooCommerce product pages now include additional Faire fields:

    Wholesale Price:The wholesale price which will be shown in Faire

    Tariff Code: The Tariff code required on this product for any international shipments

    Lifecycle State:The state of the product in Faire

    Taxonomy Type: The product type that will be shown in Faire

    Pre-order Settings:This allows you to create pre-order products for Faire, and set the applicable dates for the pre-order window

    Case Quantity: The case size you would like to sell in on Faire

    Minimum Order Quantity: The minimum order quantity you would like to set on this product at Faire


    The products page will have two new columns related to Faire:

    • Faire State: This indicates the state of the product on Faire. This can be updated within the product listing under Lifecycle State. You can also bulk edit the product state here by multi-selecting products.
    • Faire Product: Gives you the ability to sync details on a product level using the Sync button.

    How do I manage Faire orders in WooCommerce? 

    Once Faire orders are synced to WooCommerce, you can accept the order and add shipping information to sync it back to Faire: 

    1. Go to the Orders section in WooCommerce
    2. Select the Faire order you want to manage
    3. In the Faire order management card on the right:
      1.  Select Accept Order to move the status from New to Unfulfilled in Faire.
      2. Enter the required shipping details:
        1. Shipping method
        2. Shipping cost
        3. Tracking number

    Once submitted the shipping details will sync back to Faire. Payment status does not sync between platforms. After you’ve been paid through Faire, you’ll need to manually update the payment status in WooCommerce if needed.