This article explains which metafields are needed to create Verisart Certificates of Authenticity through using the Shopify App.

Metafields in Shopify

Metafields are extra pieces of data that can be attached to Shopify products. They are useful for storing information that isn't part of the basic product information but is needed for other purposes. The dimensions of an object are a good example: height and width aren't captured in Shopify's basic product info, but Verisart needs them in order to certify a product.

How to populate metafields

In order to certify products, you'll need to provide some additional information as Shopify metafields. There are three ways of doing this:

  • In the Verisart App, by clicking the Edit button on the "Check metafields" label next to the product

  • By adding required fields to a CSV file of your products and importing them using an external Shopify App like Matrixify

  • If you populate your product catalog through the Shopify API, then you can programmatically add the required metafields

List of metafields

The Verisart App creates basic certificates using the information you've already provided to Shopify: The product's title and image.

We strongly recommend that you provide additional details to make your certificates more complete. This will give your customers full confidence in the accuracy and authenticity of the certificate and their purchase.

We've outlined all the additional fields below.

Information

Description

Metafield name

Format

Artist ID

Unique artist ID assigned by the Verisart system

verisart.artist_id

Predefined string, e.g., 6d2b9a5e-8972-421d-b307-4d7ab136c3e7

These unique IDs can be found on the Creators tab

Title

Overrides the product name if the artwork should have a different title

verisart.title

String

Image(s) of the product

Image(s) of the product

verisart.image_url_1
(To add multiple replace "_1" by a number, e.g., verisart.image_1, verisart.image_2, etc.)

URL(s) of the images in the following formats, Must begin with http://

Width

Width of the product

verisart.width

Number, e.g., 20 or 10.52

Height

Height of the product

verisart.height

Number, e.g., 20 or 10.52

Depth

Depth of the product, required for sculpture

verisart.depth

Number, e.g., 20 or 10.52

Unit of measure

What unit of measure is used for the dimensions?

verisart.dimension_unit

Must be one of the following: CM, INCH or PIXEL

Production year

Year the product was produced

verisart.production_year

Four-digit value larger than 1000, must not be a future year

Object type

What kind of product is it?

verisart.object_type

Predefined string from the Object Type list (see below)

Medium

What medium, material or format is the product made of or from?

verisart.medium

A freeform string, e.g., "Oil on canvas", "Pencil on archival paper", "MPEG4 video", etc.)

Edition number

Specific edition number for this product

verisart.edition_number

Integer, e.g., 1 or 101

Edition volume

Total number of editions. Set this value without edition_number to create unnumbered editions. This is not the same as the inventory.

verisart.edition_volume

Integer, e.g., 50 or 1000

Edition note

Additional info about the edition that appears under the edition number and volume

verisart.edition_note

String, e.g., "Made from the original cast", "Printers Proof", "Bon a Tier", etc.

AP number

Specific Artist Proof number

verisart.ap_number

Integer, e.g., 1 or 101

AP volume

Total number of Artist Proofs in this edition

verisart.ap_volume

Integer, e.g., 1 or 101

Note(s)

Text to add as a note to the certificate

verisart.note_1 (To add multiple replace "_1" by a number, e.g., verisart.note_1, verisart.note_2, etc.)

One or multiple strings, e.g., "Created for the series Cloudwalker exhibited at Gazelli Art House in April 2018"

Additional file(s)

Files to supplement the certificate, e.g.,

verisart.file_url_1
(To add multiple replace "_1" by a number, e.g., verisart.note_1, verisart.note_2, etc.)

URL of a supporting file in any of the following formats:

List of predefined object types

The object_type metafield needs to be populated with one of these values. If you need to map this list of object types to data you are exporting from another system, get in touch at support@verisart.com.

  • BOOK

  • DIGITAL_ARTWORK

  • VIDEO

  • NFT

  • PAINTING

  • SCULPTURE

  • PRINT

  • DESIGN

  • COLLECTIBLE

  • PHOTO

  • DRAWING

  • MIXED_MEDIA

  • FURNITURE

  • EPHEMERA

  • OTHER

Where to find the Artist ID

Go to 'Settings > Manage creators'. The 'Manage creators' button will take you to the Creators tab on Verisart.com.

If you're an individual artist or creator, then your own Artist ID appears in the Myself section.

If you're a business representing creators, then this will appear in the Represented section.

Did this answer your question?