Related Products Manager

Upload, preview, and apply product relationship CSVs for your Shopify store.

1. Upload CSV

Import a CSV (base_handle,related_handle). Returns a file id used for Preview & Apply.

Open →

2. Preview

Inspect grouped relationships, exclude specific pairs or entire bases before applying.

Provide a file id after first upload

3. Apply

Persist relationships to metafield list.product_reference. Optional sibling linking.

Provide a file id after first upload

Manage Relationships

Add or remove related products without a CSV. Future: view & prune existing metafield entries.

Open →

Embedded Dashboard

Polaris-based in-admin UI consolidating the workflow.

Open →

How It Works

  1. Upload: CSV parsed & grouped in-memory only (ephemeral). Returns fileId.
  2. Preview: Resolves product handles to Shopify products. Validation errors (missing base/related) are listed; excluded pairs are omitted from Apply.
  3. Apply: Writes metafield shopify--discovery--product_recommendation/related_products with product references. Optional sibling linking reciprocates.
  4. Manage Relationships: Independent page to add or prune related products without a CSV (future: surface existing metafield contents for removal inline).

All state before Apply is transient; no database rows are created beyond Shopify session storage.

Metafield namespace/key are fixed; do not change unless coordinated across all apply/read logic.