Metorik Docs
Customers

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:

1

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.

2

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.

3

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:

  1. Go to Settings → Stores in Metorik

  2. 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.

Was this helpful?
Was this helpful?