Setup

1. Turn on the app embed

Open the app. On the home page, click Open theme editor. Your theme editor opens at App embeds. Check that Lit File Upload is switched on (turn it on if it isn't), then click Save. If the embed is ever off in your live theme, the app's home page shows a warning with a button to turn it back on.

From now on, product pages show the upload field above the Add to cart button. The embed also keeps the files on the cart line when your theme adds to cart without reloading the page (cart drawers, quick add) and when shoppers use Buy it now.

2. Place the field exactly (optional)

If you want the field somewhere else on the product page, click Add the block on the home page. The theme editor opens your product template with the Upload field block. Drag it where you want it, usually right above the buy buttons, and click Save. When the block is on the page, the embed doesn't add a second field.

Using a separate product template for personalized products? Add the block only to that template. Other products then never show the field.

3. Set up the field

Under Upload fields you choose the label, the file types, the size limit, whether a file is required, and which products show the field. See Upload fields.

4. Test it

Open a product in your store, upload a file, add the item to the cart and check out. The file shows up:

• on the cart line (the file name),
• on the order in your Shopify admin, in the Uploaded files block with a preview and a download button,
• in the app under Uploads.

The home page shows a check mark for each step once we've seen it working in your live theme.

The order page block

Open any order, scroll to Blocks, click + Block and choose Uploaded files. Click the pin icon in the block's corner: from then on it shows on every order, for all staff.