How to use "Scheduled Imports"

Last updated: 2026-05-11 17:05:10

Scheduled Imports let you upload a gift card CSV and choose one date and time when the import should run—using your store timezone. Each schedule runs once (one-time).

Open the feature: In the embedded app, open the Scheduled imports tab.

What you need first

A CSV file in the same format as Import gift cards (header row, required initial_value, optional columns such as customer_email, recipient_email, etc.).
Customer emails must belong to customers that already exist in your Shopify store.
Enough remaining import usage for your subscription when you add or replace a file.
Respect the app’s maximum file size and maximum data rows (shown on the Scheduled Imports screen).

Add a schedule (steps)

Open Scheduled imports in the app.
Optionally enter a Name for the schedule.
Select your .csv file.
Set Run at in your store timezone (must be now or in the future).
Click Add schedule. The file uploads and a pending row appears in Your schedules.

At the scheduled time, your server’s scheduled import worker (cron / background job) runs the import the same way as a manual import.

Your schedules list

The table shows Name, Scheduled at, Created by, Status (Pending, Processing, Completed, Failed, Canceled), Run at, and Result. Use View import result when a log is available, and Refresh now to reload the list.

Edit or delete

Edit (for Pending only for changing run time): change name, optionally replace CSV, toggle Enabled, change Run at. Click Update or Cancel.
Delete: removes the schedule after confirmation.

Pending only: Only pending schedules can change Run at. After a run has started or finished, you cannot move the scheduled time for that same row.

Limits (reference)

Topic	Behavior
Max pending schedules	Configured per store—delete or wait for jobs to finish if you hit the limit.
Usage	CSV row count counts against your current cycle when creating or replacing a file.
File storage	May be encrypted or plaintext on disk per System configuration.
Timezone	The label on the page reflects your Shopify store timezone.

CSV reminder

Same rules as Import gift cards: header row, valid initial_value on each data row, emails must match existing Shopify customers. See your import guide or sample CSV in the Import tab.

Troubleshooting

Maximum pending schedules — Remove old pending rows or wait.
Usage / row limit — Shorten the CSV or wait for the next cycle.
Run time in the past — Pick a future time in store timezone.
Failed — Use View import result or Gift card log, fix the CSV, add a new schedule.