Customize the Square Terminal Idle Screen

Applies to: Terminal API

Learn how to customize the Square Terminal idle screen for an improved customer experience.

Link to section


You can customize the Square Terminal idle screen and showcase a seller's business and brand. The Square Terminal can display a business name, product images, or a rotating display of the business name and images that showcase products.

Link to section

Requirements and limitations

The following requirements and limitations apply to customizing the idle screen:

  • The Square Terminal software must be running the latest version.
  • You can upload images only in the Seller Dashboard.
  • Square recommends 1080 x 1920 pixels for the image size.
  • You can only upload an image in the Seller Dashboard after you've paired a Square Terminal and after you've created a device code with the Terminal API. Otherwise, the Seller Dashboard doesn't display the option to upload the image.
Link to section

Customize the idle screen

Customizing the idle screen involves the following steps:

  1. Setting up the seller's business name.
  2. Uploading an idle screen image to the Seller Dashboard.
  3. Configuring the display settings in the Square Terminal and showing the idle screen.
Link to section

Edit a business name to display on the idle screen

To configure a custom idle screen for the Square Terminal, you must be logged in and perform the following steps:

  1. In your Square account, open the Seller Dashboard.

  2. In the left pane, choose Settings, and then choose Account & Settings.

  3. Choose Business information, choose Locations, and then choose the seller's location from the list.

    The Location Details form displays. You can also create a new location from the list.

  4. Under Basic Information, review or edit the seller's business name for Location Business name.

Link to section

Upload an image to the Seller Dashboard

  1. While on the Location Details form, scroll down to Terminal Background.

  2. Upload one or more images for the Square Terminal to display. You should see the following section:

    An image of the Locations Details page where you upload a background image file for the Square Terminal


    If you don't see the Terminal Background section on the Location Details form, one or more of the following issues might have occurred:

    • The Square Terminal isn't connected.
    • The Square Terminal isn't updated to the latest software version.
    • The Square Terminal isn't paired with the POS application with a device code.

    Make sure to review the requirements and limitations and connect, update, and pair the Square Terminal.

Link to section

Configure the Square Terminal display settings

  1. On the Square Terminal signed-in screen, swipe from the left to open the menu screen.
  2. Tap Settings, tap Hardware, and then tap Display.
  3. Enable Show image to display the images that you uploaded to the Seller Dashboard.
  4. Enable Show business name to display the seller location's business name.
  5. If you uploaded multiple images, specify the duration (in seconds) for the Square Terminal to display each image before transitioning to the next image.