Dropslot

DocsReference

Settings reference

Every setting of the Upload field and Text field blocks, as they appear in the theme editor.

Updated Nov 19, 2026

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#

SettingTypeDescription
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

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.

SettingTypeDescription
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)#

SettingTypeDescription
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#

SettingTypeDescription
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#

SettingTypeDescription
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.

SettingTypeDescription
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.

SettingTypeDescription
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#

SettingTypeDescription
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

Something unclear or out of date? Email dropslot@dcoded.dev.

Esc
  • Try , or .

More Shopify apps from DCODED