---
title: CheckoutBrandingColorRoles - GraphQL Admin
description: A group of colors used together on a surface.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingColorRoles
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingColorRoles.md
api_name: admin
api_type: graphql
type: object
---

# Checkout​Branding​Color​Roles

object

Requires access to checkout branding settings and the shop must be on a Plus plan or a Development store plan.

A group of colors used together on a surface.

## Fields

* accent

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

  The color of accented objects (links and focused state).

* background

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

  The color of the background.

* border

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

  The color of borders.

* decorative

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

  The decorative color for highlighting specific parts of the user interface.

* icon

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

  The color of icons.

* text

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

  The color of text.

***

## Map

### Fields with this object

* [CheckoutBrandingButtonColorRoles.hover](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingButtonColorRoles#field-CheckoutBrandingButtonColorRoles.fields.hover)
* [CheckoutBrandingColorScheme.base](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingColorScheme#field-CheckoutBrandingColorScheme.fields.base)
* [CheckoutBrandingControlColorRoles.selected](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingControlColorRoles#field-CheckoutBrandingControlColorRoles.fields.selected)