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

# CheckoutPromotion

GraphQL object

The checkout promotion

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/types/objects/checkout-promotion

## Fields

- `banners` — The checkout promotion banners.
- `entityId` — The ID of the promotion rule. Null for manual discounts.
- `displayName` — The display name of the promotion. Null when not available.
- `priority` — Order in which the promotion rule is applied. The lower the value, the higher the priority. Null for manual discounts.
- `discounts` — The discounts applied by this promotion. Empty when the discount details are not available.

## Definition

```graphql
type CheckoutPromotion {
  banners: [CheckoutPromotionBanner!]!
  entityId: Int
  displayName: String
  priority: Int
  discounts: [CheckoutPromotionDiscount!]!
}
```