Custom metafield mapping: read and write AI content to any field

By default, StoreRank reads your existing product data (title, description, meta fields) and writes the AI-optimized version back to the same field, overwriting the original.

But some merchants want to keep their original content untouched and store the AI-optimized version in a separate custom metafield. Custom metafield mapping lets you do exactly that.

Where to find it

Go to Content Settings and scroll to the bottom. Click Advanced field mapping to expand the section.

How it works

For each content type (product title, product description, meta title, meta description), you can configure two things:

Read from (input): Where StoreRank pulls the original content to optimize. By default this is the standard Shopify field.

Write to (output): Where StoreRank saves the AI-optimized content. By default this is the same standard field, meaning the original gets replaced.

Common setups

Standard (default): StoreRank reads your product description and writes the optimized version back to the same field. Your original content is replaced.

• Read from: descriptionHtml

• Write to: descriptionHtml

Keep original, add a GEO version: StoreRank reads your product description but writes the optimized version to a separate custom metafield. Your original stays untouched.

• Read from: descriptionHtml

• Write to: metafields.custom.geo_description

Use a custom source field: StoreRank reads from a custom metafield (e.g. raw marketing copy you maintain separately) and writes the optimized version to the standard product description.

• Read from: custom_raw_copy (your custom metafield)

• Write to: descriptionHtml

How to fill in the fields

For standard Shopify product fields (input), enter just the field name without any prefix. For example:

• title (not product.title)

• descriptionHtml (not product.descriptionHtml)

• seo.title

• seo.description

This ensures you're always referencing product-level fields, not fields from other Shopify objects.

For custom metafields (output), use this exact format:

metafields.namespace.key 

For example: metafields.custom.geo_title

How to find your metafield names

If you already have custom metafields set up and need to find the exact namespace and key:

1. Go to any product in Shopify Admin

2. Scroll down to the Metafields section

3. Click View all

4. On the Product Metafields page, click View unstructured metafields (top right)

5. You'll see a list of all metafields. The name on the left side is what you need (e.g. custom.geo_title)

6. Add metafields. in front of it when entering it in StoreRank (e.g. metafields.custom.geo_title)

How to display custom metafields on your storefront

Writing AI content to a custom metafield doesn't automatically show it on your store. You need to connect it to your theme:

1. Go to Shopify Admin → Settings → Custom data → Products

2. Create a metafield definition matching the namespace and key you used (e.g. namespace: custom, key: geo_title)

3. Open the Theme editor for your active theme

4. On the product page template, add a new block or section

5. Use Connect dynamic source and select your custom metafield

6. Position it wherever you want it displayed (e.g. below the main description, in a separate tab, etc.)

When to use this

Most merchants don't need custom mapping. It's useful if:

• You want to keep your hand-written descriptions and display the AI version separately (e.g. in a tab or collapsible section)

• You use a custom metafield as your "source of truth" for product copy and want StoreRank to read from there

• You want to A/B test original vs. AI-optimized content by showing them in different places