Select the Upload field or Text field block in Online Store → Themes → Customize to change these. Settings marked Pro or Plus only take effect on those plans.
Basics#
| Setting | Type | Description |
|---|---|---|
Label label | text | Also the name of the file link on the cart and order. |
Help text help | text | Optional, shown under the label. |
Require an upload before add to cart required | checkbox | Off by default |
Accepted files accept | select | Photos (JPG, PNG, HEIC, WEBP) · Photos and PDFs · Any file, incl. AI, PSD, SVG, ZIP (Pro) |
Files per order line (more than 1: Pro)Pro max_files | range | 1–10, default 1 |
Largest file max_mb | range | 1–20 MB, default 20 |
Print quality (Pro)#
Reject photos smaller than this. For a print, multiply inches by 300: an 8 × 10 in print needs 2400 × 3000 px. Orientation doesn't matter.
| Setting | Type | Description |
|---|---|---|
Minimum width (px)Pro min_width | number | |
Minimum height (px)Pro min_height | number | |
Print sizePro print_size | text | The printed area's width × height, in in, cm or mm. Photos crop to its shape, and each order gets a print file at this size (300 DPI) with a Print line that says what to print. Overrides the crop ratio below. For example: 8 x 10 in |
Crop photos toPro crop | select | On Plus, products with a mockup skip this: customers fit their photo to the print area's own shape instead. Don't crop · Square 1:1 · Portrait 4:5 (8 × 10) · Portrait 2:3 (4 × 6) · Portrait 3:4 · Landscape 5:4 (10 × 8) · Landscape 3:2 (6 × 4) · Landscape 4:3 · Wide 16:9 · Tall 9:16 |
Crop shapePro crop_shape | select | Customers fit their photo inside this shape when they crop. The print file is cut out along it (transparent PNG); their original photo is saved too. Square unless you set a size or ratio above. Rectangle · Circle · Rounded corners · Heart · Star |
Mockup preview (Plus)#
| Setting | Type | Description |
|---|---|---|
Show the previewPlus mockup_where | select | Product photos placed in Dropslot → Mockups show the customer's photo, and follow the variant they pick. On the product photos · Below the upload field |
Mockup image (optional)Plus mockup | image_picker | Only to use a different image than the product's own photos. Place it in Dropslot → Mockups, or use the sliders below. |
Print area leftPlus area_x | range | 0–100 %, default 25 |
Print area topPlus area_y | range | 0–100 %, default 25 |
Print area widthPlus area_w | range | 1–100 %, default 50 |
Print area heightPlus area_h | range | 1–100 %, default 50 |
Blend with the product's shadingPlus mockup_blend | checkbox | Folds and curves show through the photo, like real print. Best on white or light products. Off by default |
Style and visibility#
| Setting | Type | Description |
|---|---|---|
Accent color accent | color | |
Only on products tagged only_tag | text | Leave empty to show on every product that uses this template. |
Show for variant variant_value | text | Show this field only while a variant with this option value is selected, e.g. Heart (or Heart, Star). Add one block per design, each with its own crop and print size. Leave empty for every variant. For example: Heart |
Text field: Basics#
| Setting | Type | Description |
|---|---|---|
Label label | text | Also the name of the text on the cart and order, e.g. Name to engrave. |
Help text help | text | Optional, shown under the label. |
Placeholder placeholder | text | Example text shown in the empty field, e.g. Emma. |
Require text before add to cart required | checkbox | Off by default |
Most characters max_length | range | 5–250, default 40 |
Allow several lines multiline | checkbox | For messages and notes. Leave off for names and initials. Off by default |
Text field: Font and print-ready text (Pro)#
Customers see their text in your font as they type, or pick one of up to 4 fonts. Set a print size and each order also gets the text as a transparent PNG at 300 DPI, plus a Print line that says what to print.
| Setting | Type | Description |
|---|---|---|
FontPro font | font_picker | |
Fonts customers can choose fromPro font_choices | range | 1: everyone gets the font above. 2–4: customers pick from it and the next fonts. 1–4, default 1 |
Font choice 2Pro font_2 | font_picker | |
Font choice 3Pro font_3 | font_picker | |
Font choice 4Pro font_4 | font_picker | |
Text colorPro text_color | color | |
Print sizePro print_size | text | The text area's width × height, in in, cm or mm. Leave empty for text on the order only. For example: 3 x 1 in |
Text field: On the product photo (Plus)#
Draw the customer's text on your product photo as they type, in their font. Set the area below; the theme editor shows it live when you type in the field.
| Setting | Type | Description |
|---|---|---|
Show the text on the product photoPlus on_photo | checkbox | Off by default |
Text area leftPlus text_x | range | 0–100 %, default 30 |
Text area topPlus text_y | range | 0–100 %, default 60 |
Text area widthPlus text_w | range | 1–100 %, default 40 |
Text area heightPlus text_h | range | 1–100 %, default 12 |
CurvePlus text_curve | range | For mugs and bottles: bows the text with the surface. -20–20 %, default 0 |
Blend with the product's shadingPlus text_blend | checkbox | On by default |
Text field: Style and visibility#
| Setting | Type | Description |
|---|---|---|
Accent color accent | color | |
Only on products tagged only_tag | text | Leave empty to show on every product that uses this template. |
Show for variant variant_value | text | Show this field only while a variant with this option value is selected, e.g. Heart (or Heart, Star). Leave empty for every variant. For example: Heart |