> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# FAQ

## How will a promotion be applied to shoppers associated with a targeted segment?

For a promotion to apply, you must assign a customer to the targeted segment, and they must sign in to the subject storefront.

For automatic promotions, the discount automatically applies itself to the cart of each eligible signed-in customer. For coupon promotions, the signed-in customer must enter a valid coupon code associated with the promotion during checkout.

## Can you segment guests where customer\_id=0?

Not currently. This version of the Customer Segmentation API doesn’t support segmenting guest shoppers; only registered customers can be assigned to segments.

## How many segments are supported?

We currently support up to 1000 segments per **store**.

## What’s the difference between customer segments and customer groups?

Customer groups allow you to group shoppers based on more permanent characteristics, like tax zones or shopper consent to collect GDPR-compliant data. A registered customer can only belong to one group at a time.

Customer segments provide greater flexibility. They leverage both the permanent and transient characteristics of a shopper to drive highly personalized shopping experiences. A [shopper profile](/developer/docs/admin/customers/customer-segmentation/definitions-and-relationships#shopper-profile) can belong to multiple segments.

## Resources

### Articles

* [Customer Segmentation API Overview](/developer/docs/admin/customers/customer-segmentation)
* [Customer Segmentation API Guide](/developer/docs/admin/customers/customer-segmentation/user-guide)
* [Definitions and Logical Relationships](/developer/docs/admin/customers/customer-segmentation/definitions-and-relationships)
* [Promotions API](/developer/docs/admin/customers/customer-segmentation/promotions-api)

### Endpoints

* [Customer Segmentation V3 API Reference](/developer/api-reference/rest/admin/management/customer-segmentation)