How Products Sync¶
Products are maintained for you. Understanding when that happens explains most of what you'll see in WooCommerce.
When a product is created or updated¶
| Event | What happens |
|---|---|
| A listing is published | Its product is created, or updated if one exists |
| A published listing is saved | Its product is updated |
| A listing is moved to trash | Its product is deleted |
| A draft is saved | Nothing — drafts have no product |
| Product Scan is run | Every published listing across all types is created or updated |
Products are linked to listings in both directions, so the connection survives renames and re-saves.
What gets copied¶
| WooCommerce field | Comes from |
|---|---|
| Title | The listing's title |
| Price and regular price | The deposit, calculated from your Deposit Type |
| Description | The listing's content |
| Product category | The listing type's plural name, created in WooCommerce if it doesn't exist |
| Featured image | The listing's first gallery image |
| Gallery images | The listing's remaining gallery images |
| Stock quantity | The Quantity Category, or 1 if unset |
| Status | Published and catalog-visible |
Products are created as simple products with stock management enabled.
Edits made directly in WooCommerce are overwritten
Every field in the table above is rewritten from the listing on each sync, so changing a generated product's title or description in WooCommerce lasts only until that listing is next saved or scanned.
Treat the listing as the source of truth. To customise what's written, use the product args filter rather than editing products by hand.
Versions before 1.1.1 set the product title only at creation, so renaming a listing left the old product name in place.
Image hotlinking¶
If the listing type has image hotlinking enabled, product images are served from the remote source rather than your media library, matching how DMS displays them.
Product visibility in your store¶
Generated products are published and visible in the WooCommerce catalog, and grouped into a category named after the listing type — Cars, Boats.
That means they can appear in your shop pages and store search alongside any other products you sell. If you don't want vehicles listed there, exclude that product category from your shop page in WooCommerce or your theme.
Direct visits to a generated product URL redirect to the listing, so a customer following an old link or a search result still lands somewhere sensible.
Orders¶
An order records the product, so you can trace it back to the vehicle. Order handling, emails, refunds, and reporting are WooCommerce's — the extension doesn't add its own order screens.
If Reduce Quantity is enabled, completing an order writes the reduced quantity back to the listing. See Reduce Quantity.