Overview

The Shopify Product Scrubber converts raw Shopify product export files into a Luminous-ready import format. This tool automatically structures products, variants, categories, and required fields so files can be uploaded directly using the Luminous Unified (6-in-1) Importer—saving hours of manual data cleanup.

This feature is designed for teams importing large Shopify catalogs into Luminous.

What this tool does

  • Converts Shopify product exports into a Luminous Unified Importer template
  • Automatically creates Master SKUs and attaches variants
  • Splits nested Shopify product categories into Category and Subcategory fields
  • Generates variant options for each SKU
  • Concatenates variant values into product names where required
  • Flags data validation issues before import

Before you begin

Step-by-step: Convert a Shopify product file

1. Export products from Shopify

Export the product file from Shopify. This file contains raw product and variant data.

2. Upload the file to the Shopify Product Scrubber

  1. Open the Shopify Product Scrubber
  2. Upload the exported Shopify product file as excel file

3. Choose product structure in the Configure tab

a. Select how products should be created in Luminous:

b. Under Structural logic, you need to select either of following:

  • Master + Variants – Creates a master SKU (also known as Parent Product) with variants attached.
  • Flat Products – Converts all items (Unique Shopify SKU) into master SKUs with no variants.

4. Select which product statuses to include

Choose which Shopify product statuses should be processed:

  • Active
  • Draft
  • Archived

Example:

  • Include Active products only
  • Ignore Draft and Archived products

5. Choose category logic

Select how categories should be handled:

  • The scrubber uses the first level of the Shopify category as the Category
  • The last nested value becomes the Subcategory

This automatically converts Shopify’s nested category format into Luminous-compatible fields.

6. Run the scrubber

Click Run Scrubber to process the file.

After processing, the tool displays:

  • Total number of Master SKUs created
  • Total number of Variants created
  • Any data validation issues that may need review

7. Download the scrubbed file

  1. Download the processed file
  2. The output is formatted specifically for the Luminous Unified (6-in-1) Importer

How data is transformed

Master SKUs and variants

  • Shopify exports only support variants
  • Luminous requires a Master SKU
  • The scrubber automatically:
    • Creates a master SKU
    • Attaches all related variants to it

Product names

  • Variant values are automatically concatenated to the product name
  • This ensures each variant has a clear, unique name in Luminous

Variant options

  • Variant options are automatically created
  • Multiple option values are separated by commas

Example:

  • Color: Red, Blue
  • Size: Small, Medium

Import into Luminous

Upload using the Unified Importer

  1. Go to Tools > Imports in Luminous
  2. Open the LUMINOUS UNIFIED IMPORTER
  3. Upload the scrubbed file
  4. Review and confirm the import

Categories, subcategories, master SKUs, and variants are already mapped and ready for import.

Tips and best practices

  • Review data validation issues before importing
  • Use Master + Variants unless flat products are required
  • Verify category assignments if Shopify categories are deeply nested