Zone Reference

This page lists all zone keys returned by the widget’s zone-selected event. Use these keys to map body zones to products, categories, or filters in your store.

How Zone Keys Work

When a user clicks a body part in the widget, you receive a postMessage event with a zoneId field:

window.addEventListener('message', (event) => {
  if (event.data?.source !== 'persoscan-widget') return;
  if (event.data.type === 'zone-selected') {
    const zoneId = event.data.data.zoneId; // e.g. "lower-back"
    const zoneName = event.data.data.zoneName; // e.g. "Lower Back"
  }
});

Use the zoneId value to redirect users or filter products. The tables below show every possible zoneId and what body part it represents.

Grouped Zones (Default Mode)

These 23 region keys are returned when zoneDetailLevel=grouped (the default). Most stores only need this mode.

Detailed Zones (Pro/Team Mode)

These 158 precise zone keys are returned when zoneDetailLevel=detailed. This mode requires a Pro or Team license.

Next Steps

• Quick Start: canonical onboarding and event setup
• PostMessage API: full event and command contract
• E-commerce Integrations: platform-specific setup guides using these zone keys
• Configuration: set zoneDetailLevel to switch between grouped and detailed modes