> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/models/work-in-the-app/editor/realtime-indicators.md).
# Realtime Indicators
Realtime Indicators (**RTI**) provide a visual way to interpret field values in YouDesign Models, using colors and visual cues to enhance the readability of boards and diagrams. This feature makes it easy for users to identify important information at a glance, facilitating quicker decision-making.
[Watch: Realtime Indicators in YouDesign Models](http://www.youtube.com/watch?v=N9FNfjUjUb4)
*Realtime Indicators applied on Board content.*
## Applying Realtime Indicators
To apply Realtime Indicators to your board, follow these steps:
1. Open the board in **Edit Mode**.
2. Click the Realtime Indicator **Icon** in the **top right widget toolbar**.
3. The **Realtime Indicator Panel** will appear on the right side of the screen.
The panel has a **Records** tab for indicators on shapes and a **Relationships** tab for indicators on relationships and related-list connections.
The RTI panel has two sections:
* The top section allows you to select a table, field, and style of the Realtime Indicator.
* The bottom section is the **Legend**, showing all the selected and applied Realtime Indicators.
4. Select the **table**, **field**, and **style** for the RTI. You can position the RTIs within or outside of the shape. After your selections, click the **Add** button to apply the RTI.
## Interacting with Realtime Indicators
The RTI **Legend** is your main interface for managing, highlighting, and filtering RTI data.
* **Expand/Collapse** the Legend, which is organized by **Table > Field > Indicator Value**.
* You can toggle the **ON/OFF** switch to enable or disable the RTIs or remove them by clicking the **X** icon.
* Clicking on an **Indicator Value** will highlight its associated shapes. You can select multiple values to apply an **AND/OR** logic to filter and analyze the data.
> **Note:** Once a Realtime Indicator is applied, it cannot be selected again.
## Future State Indicator
The toggle in the panel header marks every record and relationship that is **future state** (planned in YouDesign Models, not yet committed to ServiceNow) so you can tell proposals from live data at a glance. The setting is stored with the board version.
The Future State Indicator toggle next to the visibility and refresh buttons
When a selection mixes current and future items, the format toolbar groups them by state so you can style each group separately.
## Fields Reached Through a Reference
Indicators can be configured on **dot-walked** fields, for example `business_unit.company` on an application, so a shape can reflect a value stored on a related record. The indicator carries the label of the related field. Admins set this up in the indicator record; see [Dot-Walked Source Fields](/models/admin/realtime-indicators.md#dot-walked-source-fields).
## Refreshing Realtime Indicators
Use the **Refresh** button at the top of the RTI panel to reload the latest backend data and ensure that your indicators reflect the most up-to-date information.
## Using Realtime Indicators in Presentation Mode
In **Presentation Mode**, users can view but not modify or delete the Realtime Indicators.
## Realtime Indicators Configuration
Admins can configure Realtime Indicators within YouDesign Models. For more detailed configuration instructions, refer to the Realtime Indicators Configuration documentation.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.ins-pi.com/models/work-in-the-app/editor/realtime-indicators.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
