> For the complete documentation index, see [llms.txt](https://ce-docs.keywordrush.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ce-docs.keywordrush.com/woocommerce/product-synchronization.md).

# Product synchronization

Content Egg offers can be used to sync with WooCommerce products. This will speed up the process of creating products (you don't need to manually set the product's price, image, description, or URL). In addition, when updating the price in the Content Egg module, the WooCommerce product's price will also be automatically updated.

### Manual synchronization

On a WooCommerce product, add your Content Egg offers as usual, then open the offer you want to sync in its **edit drawer** (double-click its row) and turn on **Woo sync**.

<figure><img src="https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M3fnB7iKYwDc1Xhr3H3%2Fuploads%2Fgit-blob-11e2e098f9884a77e09d3d8a8e8dc222407570ca%2Fwoo-sync-drawer.webp?alt=media" alt="Woo sync and Woo attr toggles in the product edit drawer"><figcaption><p>Turn on Woo sync (and, optionally, Woo attr) in the edit drawer</p></figcaption></figure>

The chosen offer is marked with a **Woo sync** badge in the product list.

Now, every time the price is updated in Content Egg, the price will be changed in the WooCommerce product. Fields such as the short description, image, and URL (for external products) are also synchronized.

{% hint style="info" %}
When you create a new WooCommerce product, you should set at least the Title field. Otherwise, the product will not be saved.
{% endhint %}

{% hint style="info" %}
Select an External/Affiliate type of product if you want your "Buy now" link to be redirected to the partner’s site. Otherwise, it will go to the shop cart.
{% endhint %}

### Auto synchronization

Go to `Content Egg > Settings > WooCommerce`. These settings decide which offer is synchronized automatically, and from which modules.

#### Automatic Synchronization Criteria

Choose which offer of the product is synchronized (by default, the cheapest one on the page):

* **Minimum Price**
* **Maximum Price**
* **Random**
* **Manually Only** — nothing is synchronized automatically. Only offers you marked with **Woo sync** are used. The scope and module lists below are then hidden, because they apply only to automatic synchronization.

![](https://4254262503-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M3fnB7iKYwDc1Xhr3H3%2F-MTVz4ZGaeJ21FNbE2yj%2F-MTW-0IN_4XXJ9_vvN3V%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=feee93b6-50e4-403c-bc44-282b8d40ed4b)

#### Automatic Synchronization Scope

Choose which modules take part. The page then shows only the module list that this choice uses:

* **Only selected modules** — only the modules you tick in **Automatic Synchronization Modules**. If you activate a new Content Egg module later, come back and tick it.
* **All product modules** — every module that returns products, except the ones you tick in **Excluded from Automatic Synchronization**. New modules are included on their own. Coupon modules are not listed, because a coupon has no price.

New installs start with **All product modules**. A site that is already running keeps **Only selected modules**, so an update does not change which offers set your prices.

{% hint style="warning" %}
If the scope is **Only selected modules** and no module is ticked, nothing is synchronized and the product prices never change. The settings page then shows the warning "Automatic synchronization is off: no module is selected." with a button, **Switch to all modules**. Click it to start updating WooCommerce prices from your offers.
{% endhint %}

#### How the offer is chosen

With **Minimum Price**, Content Egg takes the cheapest offer that is in stock:

* Offers in different currencies are compared after they are converted to one currency. The price that goes to WooCommerce is converted to your store currency.
* Shipping cost is not counted. Only the offer's price is compared.
* Offers that are out of stock come after all offers that are in stock. They are used only when nothing else is left.
* If two offers cost the same, the module with the higher priority (the lower **Priority** number in the module settings) wins.
* With [**Used and Refurbished Offers**](https://ce-docs.keywordrush.com/pages/TA9j9L3eXbz725td1kvb#id-2.-keep-used-and-refurbished-offers-out-of-the-best-price) set to exclude them, used and refurbished offers are never chosen.

**Maximum Price** works the same way, from the other end. **Random** picks any offer.

#### When synchronization runs

The Content Egg offer's data is synced with the WooCommerce product each time that:

* A WooCommerce product is created or edited
* The price of a Content Egg offer is updated.

{% hint style="info" %}
Manual synchronization has priority over automatic synchronization. An offer you marked with **Woo sync** is always used, even if it is used or refurbished.
{% endhint %}

#### When no new offer is left

Suppose **Used and Refurbished Offers** is set to exclude them, and every offer of the product is used or refurbished. The product is then handled like a product whose offers are all out of stock: a simple product is set to out of stock, your **Out of Stock Products** setting is applied (hide the price, hide the product from the catalog, or move it to the trash — see [Out-of-stock products](https://ce-docs.keywordrush.com/updating-products/out-of-stock-products.md)), and the last price is left as it was. When a new offer appears again, the product is synchronized as usual.

### GTIN

With **Sync GTIN (WooCommerce native)** set to **Enabled** in `Content Egg > Settings > WooCommerce`, the GTIN of the synchronized offer is copied to the product's **GTIN, UPC, EAN, or ISBN** field (WooCommerce 9.2 or later). The synchronized offer can change — with **Minimum Price** it is whichever offer is cheapest — so the field follows it, and it is cleared when that offer has no GTIN.

Products built by an AI assistant keep their GTIN. Such a product has a **product passport**: the product's identity, stored on the page (see [Build a price-comparison page](https://ce-docs.keywordrush.com/pages/yvzNkX4Xjqrhsd8sa5iH#id-5.-build-a-price-comparison-page)). Its GTIN field is set from the passport, and the synchronization never changes or clears it. If another product already has the same GTIN, WooCommerce keeps the field as it was, and the assistant tells you.

### Variant families

If your variants are separate products (a phone in 128, 256 and 512 GB), an AI assistant can link them as a [variant family](https://ce-docs.keywordrush.com/set-up-products/price-comparison-websites/variant-families.md). Two settings in `Content Egg > Settings > WooCommerce` apply to products that belong to a family. Products outside a family are not affected.

* **Variant Switcher** — shows the links to the other variants of the product, with their lowest prices, between the price and the Buy button. Choose **Chips** (default), **List** or **Disabled**. To place the switcher yourself, set it to **Disabled** and use the Variant Switcher block or the `[content-egg-variants]` shortcode.
* **Variant Families in Shop** — **Show every variant** (default) lists every variant as its own product in the shop and category pages. **One product per family** lists only the family's primary page, the one the assistant chose (or, without one, the published page with the lowest ID). Search results always show every variant.

{% hint style="info" %}
With **One product per family**, a family is shown through its primary page. If that page is not in a category, the family is missing from that category, even when another variant is in it. The same goes for the shop's filters: when a visitor filters by a WooCommerce attribute (color, size…) or a price range, a family whose primary page does not match the filter is missing from the filtered list, even when another variant matches. Choose as primary the variant that best stands for the family, and put it in every category the family should appear in. A filter cannot be fixed this way: if the variants differ in a filtered attribute or in price, set **Variant Families in Shop** to **Show every variant**.
{% endhint %}

A product can be added to a family only when `product` is checked in `Content Egg > General settings > Post types`. A product that is not in a family never shows a switcher, whatever these settings say.

### Why isn't synchronization occurring with the cheapest offer?

Check these in `Content Egg > Settings > WooCommerce`:

* **Automatic Synchronization Scope** is **Only selected modules**, but the module of the offer is not ticked in **Automatic Synchronization Modules**. Tick it, or switch the scope to **All product modules**.
* The scope is **All product modules**, but the module is ticked in **Excluded from Automatic Synchronization**.
* **Automatic Synchronization Criteria** is **Manually Only**.
* The cheaper offer is used or refurbished and **Used and Refurbished Offers** excludes it (`Content Egg > Settings > General settings`).
* The cheaper offer is out of stock.

Fix the setting and resave the WooCommerce product.
