> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.dintero.com/feedback

```json
{
  "path": "/docs/checkout/checkout-themes",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Custom Checkout Theme

> Customize the look of Dintero Checkout by setting backdrop, primary color, card radius, and button radius on a payment session or payment profile.

Customize the appearance of your Dintero Checkout.

A `theme` configuration can be added either to a payment session, or to a payment profile.

## Example

Custom theme configuration:

```json theme={null}
{
    "backdrop": "#E2DDF8",
    "primary": "#7863D7",
    "cardRadius": "6px",
    "buttonRadius": "6px"
}
```

Results in a checkout session that looks like this:

<img src="https://mintcdn.com/dintero-c3a7bfec/TiCvqt4VXcXnNQNe/docs/assets/checkout/custom-checkout-theme.png?fit=max&auto=format&n=TiCvqt4VXcXnNQNe&q=85&s=546c553975e945c5e9c026472c224f79" alt="Themed checkout example" width="1348" height="959" data-path="docs/assets/checkout/custom-checkout-theme.png" />

## Colors

Supported color formats are

* hex: `#ff0000`
* rgb: `rgb(255,0,0)`
* rgba: `rgba(255,0,0,0.5)`

A custom color can be specified for these entities

* **backdrop**: Color on backdrop shown in redirect desktop mode
* **primary**: Primary color used on pay button and other buttons.

## API documentation

For more details see our API specification:

* [Create a checkout session](/payments-api.html#tag/session/operation/checkout_session_profile_post)
* [Create a checkout profile](/checkout-api.html#operation/admin_session_profile_post)

## Other customizations to the checkout user interface

There are also some layout changes can be achieved via query parameters. These are not possible to set in the theme.

### Hiding the items drawer

Append the `hide_items=true` query parameter to the checkout session url to hide the items in when the checkout is not embedded (when embedded the items are hidden).

### Hiding the language selector

Append the `hide_language=true` query parameter to the checkout session url to hide the language selector.
