Clean Art Docs
Coming soon to the Shopify Theme Store

Reference · Applies to Clean Art 1.2.0

Artwork data

The product fields (metafields) Clean Art reads for artwork facts, sizes, artist notes and the wall preview, with CSV column names.

Clean Art reads product metafields in the namespace cleanart. Create them once in Settings > Custom data > Products, and set Storefront access to Public read on each. All are optional: empty fields are hidden.

Key Type Example Shown in
cleanart.artist Single line text Vincent van Gogh Artwork facts, details sheet. Falls back to the product vendor
cleanart.year Single line text 1890 Artwork facts, details sheet, Artwork details block
cleanart.medium Single line text Oil on canvas Artwork facts, details sheet, Artwork details block. Falls back to the product type
cleanart.dimensions Single line text 71 x 90 cm Product cards (size line), Artwork details block, Hero wall, A closer look
cleanart.width_cm Decimal 71 Wall preview and true-size scale. Can also be set per variant
cleanart.height_cm Decimal 90 Wall preview and true-size scale. Can also be set per variant
cleanart.original_dimensions Multi-line text Overall: 71 x 90 cm Fallback for the size row in artwork facts
cleanart.framing Single line text Framed in solid oak, ready to hang Artwork details block
cleanart.edition Single line text Edition of 50 Artwork facts, details sheet, Artwork details block
cleanart.accession Single line text 1991.67.1 Artwork facts, details sheet
cleanart.credit Multi-line text Gift of the artist Details sheet
cleanart.artist_note Rich text A note in the artist's words Artist note block on the product page
cleanart.signature File (image) A scan of the artist's signature Artist note block, under the note

Sizes without metafields

Name the size option Size, with values that include the longest side: Small, 30 cm, Medium, 50 cm, Large, 70 cm. The wall preview reads the number and works out the other side from the picture. width_cm and height_cm on a variant take priority.

Frame and Mat options

  • Frame: an option named Frame, such as No frame, Oak, Black, White. Values starting with No, None or Without show no frame in the preview.
  • Mat: an option named Mat, with values matching the Mat color blocks in the See it on a wall section.

CSV import columns

In a Shopify product CSV, add a column per field:

Column header
Metafield: cleanart.artist [single_line_text_field]
Metafield: cleanart.year [single_line_text_field]
Metafield: cleanart.medium [single_line_text_field]
Metafield: cleanart.dimensions [single_line_text_field]
Metafield: cleanart.width_cm [number_decimal]
Metafield: cleanart.height_cm [number_decimal]
Metafield: cleanart.original_dimensions [multi_line_text_field]
Metafield: cleanart.framing [single_line_text_field]
Metafield: cleanart.edition [single_line_text_field]
Metafield: cleanart.accession [single_line_text_field]
Metafield: cleanart.credit [multi_line_text_field]

Rich text and file fields (artist_note, signature) are easiest to fill in the product page in the admin.

Older stores

Stores that used custom.* fields before keep working: the theme falls back to them where the cleanart field is empty.

© Vexa · Applies to Clean Art 1.2.0SupportComing soon to the Shopify Theme Store