Where is the Partsy mapping stored in WooCommerce?

As product meta, _partsy_product and _partsy_model, edited on a Partsy tab inside Product data. That means it saves through WooCommerce's normal product save path rather than a bespoke form handler, so capability checks and revisions behave as usual.

Is the plugin compatible with HPOS and block themes?

Yes. The plugin never touches order tables or order meta, so High-Performance Order Storage is unaffected, and the storefront side is a standard action hook plus one container element rather than a template override.

What happens on a product with no Partsy mapping?

Nothing is rendered. The plugin also supports a store-wide default catalog, so you can show one diagram across a whole category while you map products individually.

WOOCOMMERCE SPARE PARTS CATALOG

WooCommerce spare parts catalog, installed as a plugin.

Q: Does the plugin need the Partsy client secret?

No. It uses the publishable key, which is read-only and refused unless the request comes from one of your allowed storefront domains. The client secret is never stored in WordPress.

Partsy adds an interactive exploded parts diagram to your WooCommerce product pages and gives every product a Partsy tab for its mapping. Shoppers click a numbered callout, see the part, and buy it from your own product page.

WordPress plugin · PHP 7.4+ · WooCommerce 8+

Start free ↗ See how the plugin works →

A digital spare parts catalog, inside the store you already run.

WooCommerce gives you a flexible catalogue and a checkout that works. What it has no concept of is the drawer of parts behind a machine: the numbered components on an exploded view, and which one a customer actually needs.

Partsy supplies exactly that layer. Your product page keeps selling the way it always did, and gains a clickable diagram above the buy box — the visual index a spare-parts buyer looks for before they know a part number.

What the WooCommerce integration actually is.

Packaged as: WordPress plugin folder, partsy-woocommerce, copied into wp-content/plugins
Installed by: Activate the plugin, then set the base URL and publishable key under Settings → Partsy Catalog
Product mapping: Product meta _partsy_product and _partsy_model, on a Partsy product-data tab
Store-wide default: Optional, for products you have not mapped individually
Renders via: woocommerce_after_single_product_summary, so no template override

Install it in four steps.

Copy the plugin in. Place the partsy-woocommerce folder in wp-content/plugins and activate Partsy Spare Parts Catalog.
Set your credentials. Under Settings → Partsy Catalog, enter your Partsy base URL and publishable key. The field rejects anything that is not a pk_ key, so a client secret cannot be pasted in by mistake.
Map a product. Open Product data → Partsy and enter the product name and model exactly as they appear in Partsy.
Publish. The diagram appears in the product summary. Unmapped products render nothing, unless you set a store-wide default.

What it does not do.

It does not replace WooCommerce. No product is duplicated into Partsy and no WooCommerce table is touched beyond the product meta it owns. Part numbers, prices, stock and shipping all stay in WooCommerce.

It needs the product summary hook. Heavily customised themes sometimes remove woocommerce_after_single_product_summary. If the diagram is missing, that hook is the first thing to check; the mapping itself is still correct.

WooCommerce must be active. Without it the plugin shows an admin notice and does nothing, rather than erroring.

WooCommerce spare parts catalog: common questions

Where is the mapping stored?

As product meta, _partsy_product and _partsy_model, edited on a Partsy tab in Product data. It saves through WooCommerce's normal product save path, so capability checks and revisions behave as usual.

Is it compatible with HPOS and block themes?

Yes. The plugin never touches order tables or order meta, so High-Performance Order Storage is unaffected. The storefront side is an action hook plus one container element, not a template override.

What happens on an unmapped product?

Nothing renders. There is also an optional store-wide default catalog, so you can put one diagram across a category while you map products one at a time.

Does it need the Partsy client secret?

No. It uses the publishable key: read-only, and refused unless the request comes from one of your allowed storefront domains. The secret is never stored in WordPress.

Other platforms

“The diagram was already the answer. Shoppers just could not click on it.”

Partsy for ecommerce / 2026