---
title: CheckoutBrandingColorRoles - GraphQL Admin
description: A group of colors used together on a surface.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
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
---

# 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)