Order flow — what happens after checkout

From paid order to print-ready file in your fulfilment hands.

Pixel Wrangler stays quiet until an order is paid. The moment it is, the print-ready files start rendering. Here's what shows up on the order, and what you can build automations against.

On the order itself

Every customized line item carries:

  • A thumbnail of the customer's design
  • A link to the full-resolution preview
  • The custom text fields they filled in

You see these in the Shopify order detail page without any setup. They also appear inside Pixel Wrangler under Orders.

Order tags

We tag every customized order with one of three values:

  • px-artwork-pending — the print files are being generated
  • px-artwork-ready — files are ready
  • px-artwork-failed — something went wrong, the order needs your eyes

These tags are how most fulfilment automations hook in. Wire your fulfilment partner's tool to watch for px-artwork-ready and you're done.

One more tag you might see: px-design-edited marks orders where you've edited the customer's design after purchase.

Order metafields

Three metafields under the px_customization namespace:

  • artwork_status — same value as the artwork tag
  • artwork_files — the list of print-ready files, with URLs
  • design_edits — an audit trail of any post-purchase design edits

If your fulfilment automation reads metafields rather than tags, that's where to look.

Where the files end up

Pixel Wrangler hosts your print-ready files and the URLs in the metafield point at them. To pull files into your own storage — for fulfilment integrations that expect a specific path, or for a longer retention policy — use the Artwork Export API; its incremental feed is built exactly for this.

When a render fails

It happens occasionally. Common reasons:

  • A sticker or background asset got deleted from your library after a customer used it
  • The customer's upload was corrupt or got pulled mid-render
  • A custom font URL went offline

Every failed order shows in the Orders tab. Open Order files and click Regenerate on the affected line — one click re-queues it. If the underlying cause is fixed, the retry succeeds and the order tag flips to px-artwork-ready.

If retries keep failing, the order detail shows the specific reason. Most fixes take under a minute.

How long files stick around

Customer-uploaded images and design session data stay accessible for 90 days from the order date. Rendered artwork data is kept longer — 180 days. After those windows, the data is cleared.

Pull what you need into your own system promptly after fulfilment. The Artwork Export API is the supported way to do this in bulk, and the Source Images Export API covers the customer's original uploads.

What's next