---
title: CheckoutBranding - GraphQL Admin
description: |-
  Creates a unified visual identity for your checkout that keeps customers engaged and reinforces your brand throughout the purchase process. This comprehensive branding system lets you control every visual aspect of checkout, from colors and fonts to layouts and imagery, so your checkout feels like a natural extension of your store.

  For example, a luxury fashion retailer can configure their checkout with custom color palettes, premium typography, rounded corners for a softer feel, and branded imagery that matches their main website aesthetic.

  Use the `Branding` object to:
  - Configure comprehensive checkout visual identity
  - Coordinate color schemes across all checkout elements
  - Apply consistent typography and spacing standards
  - Manage background imagery and layout customizations
  - Control visibility of various checkout components

  The branding configuration includes design system foundations like color roles, typography scales, and spacing units, plus specific customizations for sections, dividers, and interactive elements. This allows merchants to create cohesive checkout experiences that reinforce their brand identity while maintaining usability standards.

  Different color schemes can be defined for various contexts, ensuring optimal contrast and accessibility across different checkout states and customer preferences.
api_version: 2026-04
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/checkoutbranding
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/checkoutbranding.md
---

# Checkout​Branding

object

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

Creates a unified visual identity for your checkout that keeps customers engaged and reinforces your brand throughout the purchase process. This comprehensive branding system lets you control every visual aspect of checkout, from colors and fonts to layouts and imagery, so your checkout feels like a natural extension of your store.

For example, a luxury fashion retailer can configure their checkout with custom color palettes, premium typography, rounded corners for a softer feel, and branded imagery that matches their main website aesthetic.

Use the `Branding` object to:

* Configure comprehensive checkout visual identity
* Coordinate color schemes across all checkout elements
* Apply consistent typography and spacing standards
* Manage background imagery and layout customizations
* Control visibility of various checkout components

The branding configuration includes design system foundations like color roles, typography scales, and spacing units, plus specific customizations for sections, dividers, and interactive elements. This allows merchants to create cohesive checkout experiences that reinforce their brand identity while maintaining usability standards.

Different color schemes can be defined for various contexts, ensuring optimal contrast and accessibility across different checkout states and customer preferences.

## Fields

* customizations

  [Checkout​Branding​Customizations](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingCustomizations)

  The customizations that apply to specific components or areas of the user interface.

* design​System

  [Checkout​Branding​Design​System](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutBrandingDesignSystem)

  The design system allows you to set values that represent specific attributes of your brand like color and font. These attributes are used throughout the user interface. This brings consistency and allows you to easily make broad design changes.

***

## Map

No referencing types

***

## Queries

* [checkout​Branding](https://shopify.dev/docs/api/admin-graphql/latest/queries/checkoutBranding)

  query

  Deprecated

  * checkout​Profile​Id

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

    required

    ### Arguments

    A globally-unique identifier.

  ***

***

## CheckoutBranding Queries

***

## Mutations

* [checkout​Branding​Upsert](https://shopify.dev/docs/api/admin-graphql/latest/mutations/checkoutBrandingUpsert)

  mutation

  Deprecated

  * checkout​Profile​Id

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

    required

    ### Arguments

    A globally-unique identifier.

  * checkout​Branding​Input

    [Checkout​Branding​Input](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/CheckoutBrandingInput)

    The input fields to use to upsert the checkout branding settings (pass null to reset them to default).

  ***

***

## CheckoutBranding Mutations