Skip to main content
object

Represents information about an rollout treatment on a shop.

•RolloutChangeConnection!
non-null

The changes that this treatment makes to resources while it's served. Changes retain their id and __typename when an affected resource is deleted or the API client can't read it. Resource-specific fields are null in that case. Use query to filter by a discount's numeric ID or GID, for example discount_id:1112223334 or discount_id:'gid://shopify/DiscountNode/1112223334'. Filter by the exact public type: RolloutDiscountActivateChange, RolloutDiscountExpireChange, RolloutCatalogActivateChange, RolloutCatalogDraftChange, RolloutThemePublishChange, or RolloutCheckoutAndAccountsConfigurationPublishChange. Type values can be unquoted or single- or double-quoted. Unknown typenames match no changes. Combine type and discount_id predicates with uppercase AND, OR, and parentheses. Whitespace between predicates means AND. AND binds more tightly than OR; use parentheses to group alternatives. For example, (type:RolloutDiscountActivateChange AND discount_id:42) OR (type:RolloutDiscountExpireChange AND discount_id:99) matches only additions of discount 42 and removals of discount 99. Use discount_id:42 AND (type:RolloutDiscountActivateChange OR type:RolloutDiscountExpireChange) to scope both types to discount 42. Type-only branches preserve retained identities without requiring resource access; each discount_id predicate only matches readable, available discounts. Unreadable discounts do not suppress independent matching branches. Negation, ranges, and wildcards are not supported.

Show fields

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

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

Show filters
Anchor to discount_id
•string

Filter by the discount's numeric ID or GID.

Example:

  • discount_id:1112223334
  • discount_id:'gid://shopify/DiscountNode/1112223334'
•string

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. AND binds more tightly than OR; use parentheses to group alternatives. 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)
•Boolean
Default:false

Reverse the order of the underlying list.


•ID!
non-null

The ID of the rollout treatment.

•Rollout

The rollout this treatment belongs to.

Show fields
•Int!
non-null

The percentage of the rollout's traffic that this treatment is configured to receive. This is the configured split before other active rollouts on the same resources are taken into account.


Was this section helpful?

•interface

Was this section helpful?