Settings

Shopify Store Domain

Use either an Admin API token OR the newer Dev Dashboard Client ID + Secret.

Shopify Admin API Token (legacy/custom app token) Shopify Client ID Shopify Client Secret Shopify API Version Shopify Location

Selecting a location here will save its Shopify Location ID automatically.

Manual Shopify Location ID Fallback PerfumeSW Inventory URL PerfumeSW Bearer Token

Old automatic supplier-API sync removed: The old live Supplier API → Shopify scheduler is still disabled. v11.16 automatic sync uses the safer Supplier Cache → Snapshot Change Sync workflow.

Automatic Cache/Snapshot Sync

This is the new safe automatic workflow: refresh supplier cache, then run Sync From Cache in clean chunks using the local snapshot. It does not use the old live supplier API sync.

Enable Automatic Cache Sync Automatic Schedule

Current schedule: Every 4 hours, at the top of the hour in America/New_York. Next run: 8/2/2026, 8:00:00 PM EDT (America/New_York).

Refresh Supplier Cache Before Automatic Sync Cron Tick Secret Token

Recommended Hostinger cron: call /api/cron/tick?token=YOUR_TOKEN every 5 minutes. The endpoint only starts a run when the schedule is due and no sync is already active.

Supplier Page Size Max Pages to Sync API Request Timeout (milliseconds)

Recommended: 30000. Lower values fail faster if Shopify or PerfumeSW hangs.

Page Runtime Timeout (milliseconds)

Recommended: 600000 (10 minutes). If one supplier page runs longer than this, the app retries that page from the beginning.

Page Retry Attempts

Recommended: 2. This is separate from individual Supplier/Shopify API retries.

Supplier Retry Attempts

Recommended: 4. Retries PerfumeSW pages that timeout, return 429, or return temporary server errors.

Shopify Retry Attempts

Recommended: 5. Retries Shopify 429/throttle and temporary server errors.

Pause Between Supplier Pages (milliseconds)

Recommended: 1500 for full catalog runs. Helps prevent page/API hangs.

Pause Between SKUs (milliseconds)

Recommended: 300 for normal live syncs. Use 0 only for very small dry runs.

Dry Run

Performance Tags

Adds Shopify tags from AI Performance metafields, such as Longevity: Long Lasting, Projection: Moderate, and Sillage: Strong Trail. These can be added during AI Performance enrichment or from the standalone Performance Tags page.

Enable Performance Tags Remove Old Performance Tags Before Adding New Ones

Safe Cache Sync Controls

These settings control the main cache/snapshot sync used by the dashboard and automatic cron workflow.

Cache Sync: Use Local Change Snapshot

Recommended: Yes. The first run builds/updates the snapshot. Later runs skip Shopify calls when inventory and supplier cost are unchanged.

Cache Sync: Update Inventory Cache Sync: Update Supplier Cost Cache Sync: Update Variant Price Cache Sync: Update Compare At Price Auto Draft Products When Supplier Stock Is 0

When enabled, products touched by cache sync will be hidden from the storefront by setting Shopify status to Draft when supplier stock is 0.

Auto Reactivate Products When Supplier Stock Returns

Recommended with Auto Draft. If the supplier cache later shows stock, sync will update inventory and set the product back to Active.

Cache Sync Chunk Size

Chunked cache sync processes this many cached products, saves checkpoint, cleanly stops, waits, then continues until the catalog is complete. Try 1000 or 1500.

Pause Between Cache Chunks (seconds)

Recommended: 120. This cleanly stops between chunks to let Shopify rate limits settle before the next chunk starts.

Recommended daily sync: Dry Run = No, Snapshot = Yes, Inventory = Yes, Supplier Cost = Yes, Variant Price = Yes.

Editable Type Markups

These markups are used by Cache Sync, Automatic Sync, and Force Reprice when calculating Shopify variant prices. Everything outside the fragrance groups uses Other Products.

Designer Fragrances Markup % Middle Eastern Fragrances Markup % Niche Fragrances Markup % Other Products Markup %

Other includes Bath & Body, Makeup, Skincare, Hair Care, Nail Care, Deodorant, Shaving & Aftershave, Candles, Gift Sets, and any unknown type.

Extra Cost Per Item After Markup

Optional. Use this to build estimated shipping/handling into the selling price. Formula: (Supplier Cost × selected markup) + Extra Cost.

Round Marked-Up Price to .99

New Product Review will show Supplier Cost, Extra Cost, Markup %, Shopify Price, and Estimated Profit before you create drafts.

Protect Against Supplier Qty 0 How many consecutive zero-inventory syncs should be protected?

Recommended: 1. This avoids one bad supplier feed, but still prevents selling products that remain out of stock.

Settings Backup / Restore

Download your current settings before redeploying. After a redeploy, paste the backup JSON here or choose the downloaded file and import it.

Download Settings Backup

Import Settings Backup JSON

This restores app settings only. It does not restore supplier cache, snapshots, change reports, or sync history. Keep your SESSION_SECRET the same if your backup contains encrypted secrets.