Back to Configuration

Custom Field Mapping

4 min readLast updated: February 2026

What is Field Mapping?

Field mapping tells PageX where to find data in your store to populate schema properties. For example, you might store product weight in a metafield that PageX should use for shipping schema.

Standard Fields

PageX automatically maps standard Shopify fields:

  • Title → schema:name
  • Description → schema:description
  • Price → schema:price
  • Images → schema:image
  • Vendor → schema:brand

Custom Metafield Mapping

For custom data stored in metafields:

1. Go to Configuration > Field Mapping

2. Click "Add Custom Mapping"

3. Select the target schema property

4. Enter your metafield namespace and key (e.g., "custom.product_weight")

5. Save and re-scan affected pages

Supported Schema Properties

You can map custom fields to properties including:

  • Material and fabric details
  • Dimensions and weight
  • Country of origin
  • Warranty information
  • Energy rating
  • Age group and gender targeting

Testing Mappings

After saving a mapping, use the Field Mapping Tester to verify the data is correctly extracted before deploying.

Was this article helpful?

Still need help?

Our support team is happy to assist.

Contact Support