---
title: "Customize your Android payment terminals with themes"
description: "Create and manage themes that show during the payment flow on Android payment terminals."
url: "https://docs.adyen.com/point-of-sale/android-terminals/themes"
source_url: "https://docs.adyen.com/point-of-sale/android-terminals/themes.md"
canonical: "https://docs.adyen.com/point-of-sale/android-terminals/themes"
last_modified: "2026-05-19T16:58:00+02:00"
language: "en"
---

# Customize your Android payment terminals with themes

Create and manage themes that show during the payment flow on Android payment terminals.

[View source](/point-of-sale/android-terminals/themes.md)

You can create multiple themes to customize the appearance of your Android payment terminals. This allows you to reflect your brand identity and showcase promotions during the payment flow. You can also customize these themes for specific terminal models, and apply them at the company or merchant account level or at the level of a specific store or terminal.

If you do not create and apply your own theme, the Adyen theme and dark mode is used.

## Requirements

Before you begin, take into account the following requirements and limitations.

| Requirement             | Description                                                                                                                                                                                                                                                                                                                                                                                                       |   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| **Integration type**    | [Terminal API](/point-of-sale/basic-tapi-integration/) integration or [standalone](/point-of-sale/standalone) solution.                                                                                                                                                                                                                                                                                           |   |
| **Customer Area roles** | To create themes, you need the **Merchant POS Terminal Management Admin** role.                                                                                                                                                                                                                                                                                                                                   |   |
| **Hardware**            | All Android payment terminals on software version 1.120 or later.                                                                                                                                                                                                                                                                                                                                                 |   |
| **Limitations**         | * Theme customization is only available for the new UI introduced in terminal software version v1.120.

* For images or videos the following applies:

  * Image files (JPG, PNG, GIF) are supported on all terminals.
  * Video files (MP4, MOV) are only supported on SFO1 and M450 terminals.
  * Max. file size: 100 MB.
  * Max. video resolution: 1280 x 800 or 574 x 634 (for shopper engagement screens). |   |

## How it works

When you have your image or video files available that match the requirements:

1. You create your theme in your [Customer Area](https://ca-test.adyen.com/) at the company or merchant account level:

   1. You define the general settings for your theme by selecting dark or light mode.
   2. You check the preview for each of your terminal models, and optionally upload different or additional images or videos for the various models.

2. You apply the theme at the desired level in your [Customer Area](https://ca-test.adyen.com/): company or merchant account, store, or individual terminal.

## Create a theme

To create a general theme in your Customer Area:

1. Log in to your [Customer Area](https://ca-test.adyen.com/) and make sure you have selected the company or merchant account that you want to create a theme for.

2. Go to **In-person payments** > **Themes**.

3. Select **Create theme**.

4. On the tab for the **General** appearance:

   1. Give your theme a name,
   2. Select a **Light** or **Dark mode** for the **Appearance**.

5. Select **Save**.\
   You have now defined general settings for your theme.

6. Go to the tab for a terminal model, check the previews for the various screen types, and decide if you need to customize the theme for the combination of terminal model and screen type.

7. If customization is needed, upload videos or images to show on the following screen types:

   * **Home screen:** Upload a background image or video for the terminal's home screen.

   * **Idle screen:** Upload a screensaver for when the terminal is inactive. If a shopper interacts with the screen, the terminal returns to the **Home screen**.

     This is only available for countertop, non-battery powered terminals, for example P630, SFO1, and M450.

   * **After payment screen:** Upload an image or video to be shown after a payment is completed.

     Showing content on this screen extends the total transaction time. If another payment request is received, the terminal bypasses this screen to immediately begin the next payment.

   * **Shopper engagement screen:** Add an image or video to show during a [shopper engagement](/point-of-sale/shopper-engagement/) request. The image or video will appear on the screen together with the content from the API request.

     This is only available for terminals with larger screens, for example SFO1, M450.

8. Select **Save**.

9. If there are additional tabs for other terminal models, go to these tabs one-by-one and repeat the steps to check the previews, customize as needed, and save the changes.

You can now apply your themes to specific terminals. Otherwise, the terminals continue to use the Adyen theme.

## Apply a theme

After creating a theme, you can apply your theme to your terminals at the company, merchant, store, or terminal level. If you do not select a theme to apply, the Adyen and dark mode applies.

1. Log in to your [Customer Area](https://ca-test.adyen.com/).
2. Go to **In-person payments** > **Terminal settings** on the level where you want to apply the theme, such as company, merchant, store or terminal level, then select **Customization**.
3. Select the edit icon **, and select either **Adyen** (for the default Adyen theme) or **Custom** (for one of the themes you created).
4. Select **Save**.

The changes take effect when the terminal downloads the configuration during its maintenance call to our system.

If [WebSockets](/point-of-sale/diagnostics/check-cloud-connection/) are enabled, changes apply to your terminal almost immediately. Optionally, you can [update the configuration manually](/point-of-sale/managing-terminals/maintain-performance/#update-the-configuration-manually) on the terminal.

## Manage themes

You can manage your themes by modifying or deleting them at any time.

1. Log in to your [Customer Area](https://ca-test.adyen.com/) and if applicable, go to the company or merchant account where you created the theme.
2. Go to **In-person payments** > **Themes**.
3. To modify a theme, select a theme and make your changes, then select **Save**.
4. To delete a theme, select a theme you want to delete, select the option icon ******, then select **Delete theme**.

## See also

* [Terminal customization, hardware features, and receipts](/point-of-sale/design-your-integration/determine-account-structure/configure-features#terminal-customization-hardware-features-and-receipts)
