---
title: RolloutTreatment - GraphQL Admin
description: |-
  A treatment in a rollout. Each treatment receives a share of the rollout's
  traffic and makes a set of changes to resources for the buyers it serves.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/RolloutTreatment'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/RolloutTreatment.md
api_name: admin
api_type: graphql
type: object
---

# Rollout​Treatment

object

Requires The app must have read\_rollouts access.

A treatment in a rollout. Each treatment receives a share of the rollout's traffic and makes a set of changes to resources for the buyers it serves.

## Fields

* changes

  [Rollout​Change​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/RolloutChangeConnection)

  non-null

  The changes this treatment makes to resources while it's served. Changes retain their `id` and `__typename` if the affected resource is deleted or inaccessible. Use `query` to filter by exact public `type` or `discount_id` (numeric ID or GID). Each `discount_id` filter matches only readable, available discounts.

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    ### Arguments

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * query

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about [Shopify API search syntax](https://shopify.dev/api/usage/search-syntax).

    * * discount\_id

        string

      * type

        string

      - Filter by the discount's numeric ID or GID.

      - Example:

        * `discount_id:1112223334`
        * `discount_id:'gid://shopify/DiscountNode/1112223334'`

        Filter by an exact, case-sensitive public change typename. Unknown typenames match no changes. Combine type and discount\_id filters with uppercase AND, OR, and parentheses. Whitespace between predicates means AND. OR binds more tightly than AND, following the standard search syntax; use parentheses to group predicates. Each discount\_id predicate matches only readable, available discounts within its branch. Negation, ranges, and wildcards are not supported.

        Valid values:

        * `RolloutDiscountActivateChange`
        * `RolloutDiscountExpireChange`
        * `RolloutCatalogActivateChange`
        * `RolloutCatalogDraftChange`
        * `RolloutThemePublishChange`
        * `RolloutCheckoutAndAccountsConfigurationPublishChange`

        Example:

        * `type:RolloutThemePublishChange`
        * `type:RolloutDiscountActivateChange OR type:RolloutDiscountExpireChange`
        * `type:RolloutDiscountExpireChange AND discount_id:1112223334`
        * `(type:RolloutDiscountActivateChange AND discount_id:42) OR (type:RolloutDiscountExpireChange AND discount_id:99)`
        * `discount_id:42 AND (type:RolloutDiscountActivateChange OR type:RolloutDiscountExpireChange)`

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  The ID of the rollout treatment.

* rollout

  [Rollout](https://shopify.dev/docs/api/admin-graphql/latest/objects/Rollout)

  The rollout this treatment belongs to.

* split

  [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  non-null

  The percentage of the rollout's traffic, from 0 to 100, that this treatment is configured to receive. The splits of a rollout's treatments add up to 100.

***

## Map

### Fields with this object

* [Rollout.treatments](https://shopify.dev/docs/api/admin-graphql/latest/objects/Rollout#field-Rollout.fields.treatments)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## RolloutTreatment Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)