Documentation
How the customizer works.
Install, build templates, ship custom products. The pages below cover everything from your first template to the print-ready file that lands in your fulfilment bucket.
Category
Getting Started
Install the app and ship your first customizable product.
Quickstart
From install to your first customizable product live on your store. About five minutes of work.
Installing Pixel Wrangler
What the install actually does, the permissions it asks for, the theme blocks to add, and how to confirm the customizer is live on your storefront.
Switching from another customizer
Moving from another customizer: what to capture first, how placeholders map, matching print specs, running both apps at cutover, briefing fulfillment.
Will a product customizer slow down your Shopify store?
What a customizer adds to a Shopify product page: Pixel Wrangler is a theme app extension with one deferred script, no injected code. Measure it yourself.
Category
Building
Templates, canvases, placeholders, and the customer-facing customizer.
Templates 101
What a template is, the pieces it's made of, starting from a ready-made template, and how it connects to a Shopify product.
A tour of the template builder
The builder workspace — the tool rail, the inspector, the canvas, the Sides & Layers panel — and where each control lives.
Text placeholders
Configure the text slots customers fill in — fonts, colours, sizing, character limits, icons, border and shadow, and what customers are allowed to change.
Fonts
Google Fonts or your own font files — how to add them, where they show up, missing-character fallbacks, and what to do when a font fails.
Image, sticker, background, and mask placeholders
The four non-text placeholder types — what they do, when to use each, the per-element switches, sticker multi-select, and how layers stack.
Design Assets — your shared libraries
The stickers, backgrounds, masks, fonts, text colours and icons your templates draw from — how to add them, the limits per plan, and what happens when you delete one.
Sides and output files
Front, back, sleeves, mugs that wrap — how sides work, how to set up the print document and print files in Output Settings, and how files are named.
Products, variant images, size guides and cross-sells
Assign a template to products, swap the base image per variant colour, link a size guide page, and offer the finished design on sibling products after add-to-cart.
Surcharges and Spend & Save discounts
Charge more when a design costs more to print, and reward bigger orders with tiered discounts that the app applies at checkout.
The storefront customizer
What your customer actually sees and does — from clicking Customise, through the tools and the review step, to landing in cart and editing from there.
Styling the customizer — Brand & Language
Make the customizer look and sound like your store — the Customise button, colours, layout options, cart preview styling, and every customer-facing string.
Embedded layout — the customizer inline on the product page
Run a template's customizer in the product media gallery instead of a modal, the Settings that tell it where your theme's media lives, and the mobile sticky bar.
Cart editing — letting customers change a design before checkout
The Edit design pencil in the cart, what it needs from your theme, what customers can and can't change, and how saving updates the cart line.
Category
Order Flow
What happens after a customer buys — files, emails, fulfilment.
Order flow — what happens after checkout
From paid order to a print-ready file on the order — the tags, metafields and artwork links your fulfilment can build on, and what to do when a render fails.
Orders and order files — downloading, retrying and regenerating
The Orders page and the Order files page — statuses, bulk downloads, Retry Failed, Regenerate, the 90 and 180-day windows, and the customer's source images.
Print-ready files: specs, naming, per-side outputs and fulfillment hand-off
What renders on every order: format, size, DPI, color and bleed, per-side file naming, and how to hand files to your own line, a partner or a POD supplier.
Customizing order confirmation emails
Display custom product thumbnails and preview links in your Shopify order confirmation emails.
Editing a customer's design on an order
Fix a typo or a slipped image on a placed order, regenerate the print artwork, apply the fix to every matching item, and keep the customer's original safe.
Line item properties reference
Every _pw_ property Pixel Wrangler attaches to cart lines, the customer-visible properties you can switch on, and the Settings presets that control which ones appear.
Analytics — how the customizer is performing
The Analytics page — customised orders and revenue, the shopper funnel, template performance, artwork generation health and AI usage, and how to read each card.
Sales Channel Protection — stop undesigned orders
Why customisable products can be bought without a design through the Shop app, quick-view popups and cart links, and how the checkout guard blocks it.
Custom Reorders — let customers reorder a design they've bought
A View design button in your customer accounts that shows the exact design a customer ordered, reopens it in the customizer to tweak, and sends them through a normal checkout. Setup, what shoppers see, the Reorder tag, and when a design can't be reordered.
Category
Wrangler AI
The built-in AI tools shoppers can use, what each one costs, and how to control them.
Wrangler AI — Image Generation, Word Art, Style Remix and Background Removal
The four built-in AI tools, how to switch them on for your store and per template, Word Art presets, per-session limits, and what shoppers see.
AI usage and billing
What each AI action costs, how it appears on your Shopify invoice, the per-session limits you control, and the spending safeguards during and after the trial.
Category
Plans & billing
Platform plans, billing, and how the invoices work.
Category
API Reference
Auth, endpoints, and rate limits for fulfilment integrations.
Category
Support
Troubleshooting, FAQs, and how to get help.
Troubleshooting
The problems merchants actually hit, by symptom — storefront, builder, cart, orders and files, AI, billing — and the fix for each.
Frequently asked questions
Quick answers to the questions merchants ask before and after installing — theme changes, plans, files, fulfilment, AI, and data.
Glossary
The words Pixel Wrangler uses — template, side, layer, placeholder, print file, snapshot, artwork link and the rest — in one place.