Brevo PushOwl can sync custom Shopify metafields to your marketing platform, enabling advanced personalization and segmentation based on your unique customer data. This complements the standard customer fields covered in Customer Data Reference.
What is Attribute Mapping?
Attribute Mapping allows you to sync custom customer data from Shopify metafields to your contact attributes. This enables you to:
Personalize emails with custom customer data (birthday, preferences, etc.)
Create segments based on custom attributes (loyalty tier, shoe size, etc.)
Use custom data in automation triggers and conditions
How It Works
The Attribute Mapping interface shows two types of attributes, which you can filter using the Attribute Type dropdown:
1. Standard Shopify Attributes (One-Way Sync)
These are built-in Shopify customer fields that sync one-way from Shopify to Brevo PushOwl. Changes made in Brevo PushOwl to these attributes will be overwritten on the next sync from Shopify.
Brevo PushOwl Attribute | Type | Description |
FIRSTNAME | Text | Customer's first name |
LASTNAME | Text | Customer's last name |
SMS | Text | Customer's phone number |
CUSTOMER_ID | Text | Shopify customer numeric ID |
CUSTOMER_NOTE | Text | Custom notes on the customer |
TAGS | Text | Shopify customer tags (comma-separated) |
COMPANY | Text | Customer's company name |
ADDRESS_1 | Text | Primary address line |
ADDRESS_2 | Text | Secondary address line |
CITY | Text | Customer's city |
STATE | Text | Customer's state/province name |
PROVINCE | Text | Customer's province name |
COUNTRY | Text | Customer's country name |
COUNTRY_CODE | Text | ISO country code (e.g., "US") |
PROVINCE_CODE | Text | ISO province/state code (e.g., "NY") |
ZIP | Text | Customer's postal/ZIP code |
ORDER_COUNT | Float | Total number of orders placed |
TOTAL_SPENT | Float | Total amount customer has spent |
TAX_EXEMPT | Text | Tax exemption status |
CURRENCY | Text | Customer's preferred currency |
LOCALE | Text | Customer's preferred language/locale |
SHOPIFY_GID | Text | Shopify GraphQL API ID |
VERIFIED_EMAIL | Text | Email verification status |
MARKET_HANDLE | Text | Shopify market handle |
MARKET_ID | Text | Shopify market identifier |
CUSTOMER_CREATED_AT | Text | Customer account creation timestamp |
CUSTOMER_UPDATED_AT | Text | Customer last updated timestamp |
CUSTOMER_OPT_IN_LEVEL | Text | Customer's opt-in level |
CUSTOMER_OPT_IN_TIME | Text | When the customer opted in |
SHOPIFY_CREATION_DATE | Date | Customer creation date |
SHOPIFY_CUSTOMER_TAGS | Multiple-choice | Customer tags (multi-select) |
2. Custom Metafields (Two-Way Sync)
Custom Shopify metafields sync both ways between Shopify and Brevo PushOwl. Changes made on either platform will be reflected on the other.
New Shopify metafields appear automatically in the mapping interface as soon as they are created in Shopify. No need to assign them to a customer first.
Custom metafields can be mapped to the following attribute types:
Attribute Type | Description | Example Use |
Text | Single line text values | Customer preferences, notes |
Float | Decimal numbers | Age, shoe size, custom scores |
Date | Date values | Birthday, anniversary, join date |
Boolean | True/false values | Loyalty status, VIP flag |
Category | Predefined categories | Region, membership tier |
Multiple-choice | Multiple selectable values | Interests, product categories |
The Attribute Mapping interface in Brevo PushOwl showing custom metafield mappings with their Shopify field names and corresponding Brevo attribute types.
Setting Up Attribute Mapping
Step 1: Create Metafields in Shopify
First, create your custom metafields in Shopify:
Go to Settings > Metafields and metaobjects in Shopify admin
Select Customers
Add a new metafield definition
Choose the appropriate type (single line text, number, date, etc.)
Step 2: Map Attributes in Brevo PushOwl
Navigate to Settings > Attribute Mapping in your Brevo PushOwl dashboard
Find your new metafield in the list
Verify the Brevo PushOwl attribute name and type
Click Save Changes
The Attribute Mapping settings page where you can map Shopify metafields to Brevo PushOwl contact attributes.
Step 3: Resync Attributes
To ensure all customer data is updated with the new mapping:
Click Resync Attributes button
Wait for the sync to complete
Check the "Last synced" timestamp for confirmation
The Resync Attributes button and Last synced timestamp confirming when attribute data was last synchronized.
Supported Metafield Types
Brevo PushOwl supports mapping these Shopify metafield types:
Shopify Type | Maps To | Notes |
Single line text | Text | Direct text mapping |
Number (decimal) | Float | Numeric values with decimals |
Number (integer) | Float | Whole numbers |
Date | Date | Date only (no time) |
Date and time | Date | Converts to date format |
Boolean | Boolean | True/false values |
List (single line text) | Multiple-choice | Multiple values |
JSON | Text | Stored as text string |
Managing Attribute Mappings
Viewing Mappings
The Attribute Mapping interface shows:
Attribute field type: Whether it's a standard Shopify field or custom Metafield
Customer object field: The Shopify metafield name
Brevo PushOwl contact attribute: The corresponding attribute in Brevo PushOwl
Brevo PushOwl attribute type: The data type in Brevo PushOwl
Action: Remove the mapping
Removing Mappings
To stop syncing an attribute:
Find the attribute in the list
Click the delete icon button in the Action column
Click Save Changes
Note: Removing a mapping doesn't delete existing data in Brevo PushOwl, it just stops future syncs.
Using Mapped Attributes
In Personalization
Use mapped attributes to personalize your messages:
In Segmentation
Create segments using custom attributes:
Loyalty tier = "Gold"
Birthday is in the next 7 days
Region = "West Coast"
Age > 25
In Automations
Trigger automations based on attribute values:
When loyalty status changes to VIP
When birthday approaches
When a custom score reaches a threshold
Sync Timing
Initial Mapping
When you first map an attribute:
Existing customer values sync during the next customer sync
New customer values sync in near real-time going forward
Ongoing Sync
Event | Sync Timing |
Customer metafield updated in Shopify | Near real-time (webhook) |
Manual resync triggered | Processes all customers with that metafield |
Bulk data sync | Includes all mapped attributes |
Resync Attributes
The Resync Attributes button:
Refreshes the list of available metafields
Syncs all mapped attribute values for all customers
Updates the "Last synced" timestamp
Best Practices
Naming Conventions
Use clear, descriptive metafield names
Avoid special characters that might cause issues
Be consistent with naming across your organization
Choose Appropriate Types
Use Float for numeric values you'll want to filter by range
Use Date for dates you'll want to filter by time periods
Use Boolean for simple yes/no flags
Use Category for predefined lists with limited options
Plan Before Creating
Decide what customer data you need before creating metafields
Consider how you'll use the data in segmentation and personalization
Document your attribute naming scheme
Troubleshooting
Metafield Not Appearing
Check:
Metafield is created in Shopify under Settings > Metafields and metaobjects > Customers
Click Resync Attributes to refresh the list
Wait a few minutes for sync to complete
Attribute Values Not Syncing
Solutions:
Verify the mapping is saved (click Save Changes)
Check the customer has a value for that metafield in Shopify
Wait for the next sync cycle or trigger a manual resync
Attribute Type Mismatch
If you select an incompatible attribute type when mapping, Brevo PushOwl will show an "Attribute type mismatch" warning. For example, mapping a Shopify number_decimal type to a Brevo text type could lead to data sync issues.
The Attribute type mismatch warning that appears when a Shopify metafield type is incompatible with the selected Brevo PushOwl attribute type.
When you see this warning:
Click Cancel and select a compatible attribute type instead
If you're sure about the mapping, click "Let me update manually" to proceed, but be aware this may cause data sync issues
Sync Conflicts
Standard Shopify attributes: Shopify is the source of truth. If you edit a standard attribute directly in Brevo PushOwl, it will be overwritten on the next sync from Shopify.
Custom metafields: These sync both ways. Changes on either platform will be reflected on the other.
Common Questions
Can I sync order metafields too?
Currently, attribute mapping is available for customer metafields. Order metafields are included in order sync but aren't separately mappable.
Is there a limit to how many attributes I can map?
There's no hard limit, but for performance:
Map only attributes you actively use
Remove mappings for deprecated metafields
Consider the sync load for stores with many customers
Can I rename the Brevo PushOwl attribute?
The Brevo PushOwl attribute name is based on the Shopify metafield name. To change it, you'd need to create a new metafield in Shopify with the desired name.
Do all customers need values for mapped metafields?
No - if a customer doesn't have a value for a metafield, that attribute simply won't be set on their contact record. Your segments and personalizations should handle cases where attributes might be empty.
Related Articles
Sync Your Shopify Data with Brevo PushOwl: Overview of all data sync capabilities
Customer Data Reference: Standard customer fields synced from Shopify
Product & Collection Sync: Product metafields and catalog data
Order & Event Tracking: Order metafields and event data