---
tags:
- UI Page widgets
alias: user-guide-uipage-widgets-text-widget
widgetname: Text
description: "This documentation details configuring a UI widget for displaying static or dynamic text content"
---

# Text

!["Screenshot showing a text icon."](images/text_icon.png)

## Overview

The Text widget displays static or dynamic text in a UI Page. The user can configure the widget to receive the value to display from an external data source or a static text message can be displayed on-screen.

![Screenshot showing a text preview.](images/text_preview.png)

## General Steps

{% include-markdown 'includes/pages/ui_widgets_general_steps.md' %}

![General Steps — screenshot: text general](images/text_general.png)

## Widget Customization

1. Optionally, in the **Style** tab, you can customize the appearance of the widget with the following properties:

    * **Border Width** - Choose from the available options to set the thickness of the border: Thinner, Thin, Medium, Thick, and Thicker.
    * **Border Color** - Select the color for the border using the color picker or by entering RGB coordinates.
    * **Font** - Choose the desired font type for the date and time displayed within the widget.
    * **Font Size** - Set the size of the text. Options include Extra Small, Small, Normal, Large, Extra Large, and Dynamic (which adjusts based on the widget's size).
    * **Font Color** - Select the color for the text using the color picker or by entering RGB coordinates.
    * **Background Color** - Choose the background color for the widget using the color picker or by entering RGB coordinates.
    * **Horizontal Alignment** - Align the text horizontally within the widget. Options include Center, Left, and Right.
    * **Vertical Alignment** - Align the text vertically within the widget. Options include Middle, Top, and Bottom.

    ![textStyle](images/text_style.png)

2. In the **Setup** tab, the widget can be configured through the following fields:

    * **Text** - What to display in the widget
    * **Placeholder Text** - If the user links the **Text** field to a dynamically source, a default message can be displayed when this source is empty.

    ![Screenshot showing widget settings for text display.](images/text_setup.png)

3. Optionally, define the **Links** between this widget and other elements of the UI Page.

    ![textLinks](images/text_links.png)

4. By saving and closing the settings, the widget will be changed accordingly.