Smart Meta Importer

Tutorial & documentation

A complete walkthrough: install the app, configure settings, map CSV columns, run imports/exports, and fix common issues.

1. Getting Started

Smart Meta Importer is a Shopify app for merchants who need to bulk import and export product and variant metafields using CSV files. It is built for catalog teams that maintain rich structured data—ingredients, specs, custom attributes, nutrition tables, and more.

Use this guide if you are:

  • Installing the app for the first time
  • Setting up CSV column mapping for product/variant metafields
  • Running exports with filters
  • Diagnosing skipped or failed import rows
Tip Start with a small CSV (5–10 products) before running a full-catalog import.

2. Install the App

  1. Open the Shopify App Store listing for Smart Meta Importer.
  2. Click Add app / Install.
  3. Review the requested permissions (products, inventory, and related scopes).
  4. Confirm installation for your store.
Placeholder: replace with your App Store install screen screenshot
Install flow placeholder — replace assets/screenshots/install-app.png.
Note After install, Shopify redirects you into the embedded app inside Admin.

3. Open the App

  1. In Shopify Admin, go to Apps.
  2. Select Smart Meta Importer.
  3. Wait for the embedded app to load the home/dashboard view.
Placeholder: replace with a screenshot of opening the app from Shopify Admin Apps list
Open app placeholder — replace assets/screenshots/open-app.png.

4. Initial Setup

On first launch, review the onboarding/setup screen. Confirm your store is connected and that you can see Import, Export, Settings, Templates, History, and Pricing navigation.

  1. Open Settings (or the initial setup panel).
  2. Choose default match behavior (handle / ID / SKU).
  3. Confirm CSV delimiter defaults (usually comma).
  4. Decide whether imports should merge or replace existing metafield values by default.
Placeholder: replace with your initial setup screen
Initial setup placeholder — replace assets/screenshots/setup.png.

5. Configure App Settings

Each setting below controls how CSV jobs behave. Update these before large imports.

Setting: Product match key

What it does: Tells the app how to find the correct Shopify product for each CSV row.

How to configure: Choose handle, product ID, or another supported identifier that exists in your CSV.

Placeholder for product match key setting
Settings placeholder — replace assets/screenshots/settings.png.

Setting: Variant match key

What it does: Resolves the correct variant when importing variant metafields or inventory.

How to configure: Prefer SKU when your catalog SKUs are unique. Otherwise use the variant identifier column your export provides.

Setting: Merge vs replace

What it does: Controls whether mapped metafield values overwrite existing data or merge where supported.

How to configure: Use replace for clean overwrites; use merge when you want to preserve unrelated values.

Setting: CSV delimiter

What it does: Defines how columns are split when parsing uploads.

How to configure: Keep comma for standard CSV. Switch only if your spreadsheet locale exports semicolons.

Warning A wrong match key can update the wrong products. Always validate with a small test file first.

6. Configure Rules / Features

Map CSV columns

  1. Go to Import.
  2. Upload your CSV file.
  3. Map identifier columns (product/variant).
  4. Map each data column to a metafield namespace + key (+ type when required).
  5. Save the mapping if you will reuse it.
Placeholder for CSV column mapping UI
Mapping placeholder — replace assets/screenshots/mapping.png.

Run an import

  1. Confirm mapped columns look correct.
  2. Start the import job.
  3. Watch progress for success / updated / skipped / failed counts.
  4. Download the error log if any rows fail.
Placeholder for CSV import progress screen
Import placeholder — replace assets/screenshots/import.png.

Export metafields

  1. Open Export.
  2. Choose product, variant, or both.
  3. Apply filters (all, collection, vendor, type, tags, or selected products).
  4. Download the generated CSV.
Placeholder for CSV export filters screen
Export placeholder — replace assets/screenshots/export.png.

Optional: inventory CSV updates

If your plan and settings allow inventory updates, include quantity columns and a location-aware configuration as shown in the app. Treat inventory imports with the same test-first approach as metafield imports.

handle,custom.material,custom.care_instructions,variant_sku,custom.fit
sample-tee,Organic cotton,Cold wash,TEE-S-001,Regular
Tip Keep namespace.key naming consistent with your Shopify metafield definitions.

7. Save and Activate

  1. Save settings and mapping preferences.
  2. Confirm your plan allows the intended import volume.
  3. Activate / run the job from the Import screen.
  4. Leave the job page open until processing completes (or check History afterward).
Placeholder: replace with save and activate confirmation screen
Activate placeholder — replace assets/screenshots/activate.png.

8. Test the App

  1. Export a tiny product set (or create a 3-row CSV manually).
  2. Change one metafield value in the CSV.
  3. Import the file using your saved mapping.
  4. Open the product in Shopify Admin and confirm the metafield updated.
  5. Re-export and verify the new value appears in the CSV.
Placeholder: replace with a testing or job success screenshot
Test placeholder — replace assets/screenshots/test.png.
Note If theme storefronts cache metafield output, refresh the storefront or verify the metafield value in Shopify Admin.

9. Troubleshooting

10. FAQ

For a longer list of questions, visit the dedicated FAQ page.

Open FAQ Contact support