Usage Guide

Step-by-step guide to basic operations.

Getting Started

Installing the App

  1. 1Search for the app in Shopify App Store
  2. 2Click 'Install'
  3. 3Review permissions and approve installation
  4. 4Dashboard appears when complete

Importing Products

Step 1: Prepare CSV File

Create a CSV file with the following columns:

Title,SKU,Price,Inventory
Product A,SKU-001,1000,50
Product B,SKU-002,2000,30

Step 2: Upload File

  1. 1. Click 'Import' on the dashboard
  2. 2. Drag & drop the CSV file
  3. 3. Verify resource type is set to 'Product'

Step 3: Execute Import

  1. 1. Click 'Start Import'
  2. 2. Processing begins and progress is displayed
  3. 3. Check results in history after completion

Importing Customers

Step 1: Prepare CSV File

Email,First Name,Last Name,Phone
[email protected],John,Doe,555-1234

* Email address is required and must be unique

Step 2: Upload File

  1. 1. Open 'Import' screen
  2. 2. Include 'customer' in filename for auto-detection
  3. 3. Or manually change resource type to 'Customer'

Step 3: Execute Import

Click 'Start Import' to begin processing.

Exporting Products

Step 1: Open Export Screen

Click 'Export' on the dashboard.

Step 2: Select Columns

  1. 1. Confirm 'Product' tab is selected
  2. 2. Check the columns you want to export
  3. 3. Or select a template

Step 3: Set Filters (Optional)

To export specific products only:

  • Filter by product type
  • Filter by vendor
  • Filter by collection

Step 4: Execute Export

  1. 1. Click 'Start Export'
  2. 2. Download link appears after processing
  3. 3. Click to download CSV file

Setting Up Recurring Export

Step 1: Configure Export

Select columns as you would for a regular export.

Step 2: Set Schedule

  1. 1. Expand 'Schedule Settings' section
  2. 2. Select 'Recurring'
  3. 3. Set interval (e.g., daily, weekly)

Step 3: Save and Activate

After saving, exports will run automatically at the specified interval.

Adding Tracking to Orders

Step 1: Prepare CSV File

Name,Tracking Number,Tracking Company,Notify Customer
#1001,1234567890,FedEx,true
#1002,0987654321,UPS,true

Step 2: Upload File

  1. 1. Include 'fulfillment' or 'tracking' in filename
  2. 2. Or change resource type to 'Fulfillment'

Step 3: Execute Import

After processing, tracking info is added to each order.

Using Command Features

The command columns in your CSV let you add/remove tags, replace images, and manage variants in bulk — without overwriting data you want to keep.

Add tags (tagsCommand: ADD)

Adds the specified tags without removing any existing ones. Include the handle and tagsCommand columns in your CSV.

handle,tags,tagsCommand
my-product,sale,ADD

Replace all images (imageCommand: REPLACE)

Removes all existing images and replaces them with the specified ones. Separate multiple URLs with commas in the imageSrc column.

handle,imageSrc,imageCommand
my-product,https://example.com/new.jpg,REPLACE

Delete a variant (variantCommand: DELETE)

Deletes the variant with the specified SKU. Other variants are not affected.

handle,variantSku,variantCommand
my-product,OLD-SKU-001,DELETE

Using the Error CSV

When import errors occur, you can download a CSV containing only the failed rows. Fix the issues and re-import to resolve them efficiently.

  1. 1Open the job detail page after the import completes
  2. 2Click the "Download Error CSV" button
  3. 3Open the CSV and check the error message column
  4. 4Fix the data in the failed rows
  5. 5Re-import the corrected CSV

Files are retained for 24 hours after the import completes.

When Errors Occur

Checking Error Logs

  1. 1. Open History screen
  2. 2. Click on the relevant job
  3. 3. Error details are displayed
  4. 4. Download error log as CSV via 'Download Error Log'

Common Errors

ErrorCauseSolution
Duplicate emailCustomer with same email existsCheck/fix email address
SKU not foundNon-existent SKU specifiedCheck/fix SKU
Required field emptyRequired column has no valueCheck/add data

Tips

Customize Column Names

Change column names to match your existing CSV templates to save file processing time.

Use Templates

Save frequently used settings as templates to skip configuration each time.

Run Large Data at Night

For large datasets, use scheduling to run at night and minimize business impact.