WooCommerce: Why customer roles don't show correctly in Metorik
If a customer's role in Metorik looks different from what you see in WooCommerce — or seems stuck on an old role — this is usually caused by how third-party role plugins handle (or don't handle) data updates.
Metorik retrieves customer data through the WooCommerce API, which supports only one role per customer. When plugins add multiple roles or change roles without proper updates, Metorik may show unexpected results.
Common symptoms
Metorik shows a different role than WooCommerce admin
A role change isn't reflected in Metorik
Multiple roles visible in WooCommerce don't appear in Metorik
A custom role created by a plugin doesn't show up for filtering
What's actually happening
WordPress and WooCommerce are designed to store one role per user in the database. The API that Metorik uses only returns that single database role.
Third-party plugins that add or manage roles can create confusion in three ways:
Modified date not updated
When a plugin changes a user's role but doesn't update the modified date, Metorik doesn't know the customer record changed. The role stays stale until Metorik re-imports the customer.
Database role unchanged
Some plugins show a role change visually in WooCommerce admin but never actually update the role in the database. Metorik reads the database via the API — so it shows what's actually stored, not what the plugin displays.
Multiple roles for display only
Certain plugins allow assigning multiple roles to a user. However, WooCommerce's underlying data model only stores one role value. The additional roles are for display or filtering within WooCommerce admin — they don't exist in the API response, so Metorik cannot see or filter by them.
How to fix it
Quick fix: Reimport customers
If roles updated in WooCommerce aren't showing in Metorik, you can trigger a full reimport:
Go to Settings → Stores in Metorik
Click Reimport Customers
This forces Metorik to pull fresh customer data from WooCommerce. You can also refresh an individual customer from their profile page in Metorik.
Permanent fix: Ensure modified dates update
For role changes to sync automatically, the customer's last update time must change. If you're using custom code or a plugin to modify roles, make sure it updates the modified timestamp.
See WooCommerce: Making sure updated data gets synced to Metorik for the technical details on how to do this.
Need multiple roles? Use custom fields instead
If your business logic requires multiple classifications per customer (for example: wholesale customer, VIP member, newsletter subscriber), don't rely on roles. WordPress roles are designed as a single value.
Instead, store these classifications as custom fields on the customer or order. Metorik fully supports filtering, segmenting, and exporting by custom fields. This works for both WooCommerce and Shopify stores.
Learn more in Custom Fields.
Key takeaways
Metorik sees the actual database role via the WooCommerce API — not plugin display values
Each customer can have only one role in the underlying data
If a role change isn't syncing, check if the modified date was updated
For multiple classifications per customer, use custom fields instead of roles
If you're still having trouble with customer roles after checking these scenarios, contact Metorik support and we'll help investigate.