Shopify Split Tool

Login

Shopify Product Split Tool

Checking connection...
Run
Settings
Stock Sync
Help

Manual Split

Auto Split

Schedule active
Enable the toggle to configure automatic scheduling.

Split Configuration

Settings saved.
Active products from this collection will be processed.
The variant whose value contains this word stays in the original product.
Inserted into the sample title before the variant value. Example: with "Muestra", the sample title becomes Fakhar Man LATTAFA - Muestra 3ml. Leave empty for the legacy Title - 3ml format.

Stock Sync

Auto-sync active
Enable the toggle to configure automatic stock sync.

Scan products

Discovers master + sample pairs across your store. Required once before sync can run, and again whenever you add new split products.

Sync run

Sync log (last 20)
No log entries yet.

Quick guide

What does the app do?

It splits Shopify products that have multiple variants (e.g. a perfume with Frasco, 3ml, 5ml, 10ml) into separate standalone products. The master variant (Frasco) stays in the original product; each other variant becomes a new product, linked through metafields.

1. Configure (Settings tab)

  • Source collection — handle of the collection with the products to split. Only ACTIVE products are processed.
  • Destination collection (optional) — where new sample products are added.
  • Variant option name — the option that holds the variants (e.g. "variante").
  • Master keyword — the variant value that stays in the original product (e.g. "Frasco").

2. Manual Split (Run tab)

Simulation shows what would happen without changing Shopify. Start Split with simulation off runs it for real.

The app skips products that are already split, and products with the prepare tag.

3. Auto Split (Run tab)

Toggle it on, pick an hour and minute, save. The app runs the split automatically every day at that time (always LIVE, never simulation). Last run summary and the last 5 runs appear under the toggle.

4. Stock Sync (Stock Sync tab)

Keeps sample stocks in line with their master's stock. Scan once to map masters → samples, then enable auto-sync (or click Run sync now for a full pass). Rules:

Master stockWhat each sample gets
2 or more10 (default stock)
exactly 1by size: 10ml → 6, 5ml → 3, 3ml → 6
0Nothing changes — samples left untouched

Why nothing at 0? The master can be out of stock in Shopify while the warehouse still has physical samples — so sales keep going while you restock the master.

How auto-sync runs: on a schedule (e.g. twice a day). Most runs are incremental — only products whose stock changed since the last run are touched, so it's fast. Once a day it does a full reconcile of the whole catalog as a safety net, so any stock change is always caught. New products from the split are added to the map automatically.

Samples are matched by ml size, so Muestra 5 ml, 5ml and Muestra 5ml all hit the 5ml rule. Samples are identified by the custom.canonical_handle metafield set by the split.

Safe to rerun

Already-split products are skipped automatically. No duplicates are created. Stock Sync only writes when the target stock differs from the current value.

Connection

The status dot at the top shows the Shopify connection. Click the next to it to force a recheck if it ever shows disconnected.