Skip to main content

Using the correct metafield for syncing birthday data between Shopify and Growave

Simon Akhrameev avatar
Written by Simon Akhrameev
Updated this week

If your store already collects customer birth dates using a custom metafield, for example, through a registration app, theme customization, or a third-party form, this data will not sync with Growave automatically. As a result, birthday rewards won't be triggered through Growave.

To ensure Growave can access customer birth dates and send automated birthday rewards, your store must use Shopify’s default metafield definition:

  • Name: Birth date

  • Key: facts.birth_date


How the sync works

Once the facts.birth_date metafield is present in your store, Growave and Shopify will sync birth dates automatically in both directions:

Action

Result

Customer enters birth date via Growave widget on storefront

Data saved in Shopify under the existing standard metafield

Admin adds birthday via Growave β†’ Customers

Metafield is updated in Shopify

Admin adds birthday in Shopify Customer profile

Date appears in Growave automatically

πŸ“— Note

If the Birth date metafield (facts.birth_date) does not exist in Shopify after you install Growave, you can create it by:

  • Activating the Celebrate birthday rule under Rewards β†’ Points β†’ Ways to earn.

  • Creating a test customer account and adding a birthday to it in Growave β†’ Customers β†’ Customer profile.


Replace your custom metafield with the standard one

If you previously used a custom metafield to collect birthdays (e.g., customer_birthday, birth_date_custom, etc.), it won’t work with Growave.

To fix this:

  • In your Shopify admin, go to Settings β†’ Metafields and metaobjects.

  • Open Customer metafields and check if the Birth date with the key facts.birth_date exists.

  • If not, create it manually:

    • Click Add definition and name it Birth date.

    • Shopify will suggest the standard definition with key facts.birth_date. Select it.

    • Under Customer Account API access, choose Read and write.

  • Click Save.

    Create standard Birth date metafield in Shopify

  • Once saved, the metafield will be available for syncing with Growave and can also be used for storefront personalization.

  • Update your registration forms, theme code, or app integrations to use this standard metafield instead of your previous one.


If you have any questions or need help setting this up, feel free to reach out to us via the chat icon in the bottom-right corner of your Growave admin or email us at [email protected] β€” we're always happy to help! 😊

Did this answer your question?