Troubleshooting

Custom fields on the certificate are empty

Fields fill from product metafields and fail open, so a missing metafield leaves the field blank instead of blocking the certificate.

Fields such as Metal, Year or Origin are filled automatically from the matching product metafield when one exists. If a field renders blank, the product has no value in the metafield that field is bound to. This is deliberately fail-open: a missing metafield leaves the field empty rather than blocking the certificate from being issued at all. Fill in the metafield on the product, then press Refresh from Shopify on the certificate.

Check these in order

  1. Check the field is bound to a metafield

    In Design, open the detail line. Its value should be Custom field (from the product/order) with the right key, either metal or custom.metal.
  2. Check the product or variant has a value

    Open the product in Shopify and confirm the metafield is filled in. A variant value wins over a product value with the same key.
  3. Check the metafield type

    Files, JSON and product references cannot be printed and are labelled that way in the designer's list. Metaobject reference fields currently print blank.
  4. Check when the certificate was issued

    Metafield values are read when the certificate is issued, so a value added afterwards does not appear on an existing certificate until you refresh it from Shopify.

How to fix it

Fill in the metafield first, so every new certificate picks it up. Then open the certificate that went out blank and press Refresh from Shopify. It re-checks that item's product and variant metafields, and the buyer name, against Shopify and fills in anything still blank. It never overwrites a value already on the certificate, and the serial and verification link stay the same. The button is on every certificate issued from a Shopify order, including past orders.

If the buyer name is blank because Shopify has no name on file for that order, type it into the Buyer field on the certificate page and press Save. When the name is missing, that field reads Shopify has no name on file. Type it in here.

If it still is not working

Send us the details listed on Still stuck and we will read the issuance record for that order.


Related articles

Not on Shopify yet?

Start a free Shopify trial, then add Miko apps when you are ready.

Set up your store in minutes and try it with your own products. Loyalty, wholesale pricing, AI descriptions and the rest of the Miko apps install in one click once your store is live.