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

# Display Name for KPIs, Pivots & Measures

> GermainUX allows KPIs, measures and pivots to use display names that differ from their internal names.

Service
`Analytics`

Availability
2014.1 or later

> [card] [Configure a Display Name](#configure-a-display-name)
>
> Rename fields and measures

> [card] [Recommended Naming Practices](#recommended-naming-practices)
>
> Naming conventions to follow

## Overview

GermainUX allows KPIs, measures and pivots to use display names that differ from their internal names.

Display names make analytics easier to understand by presenting familiar business terminology instead of technical field names from the underlying data model. For example, users can search for and analyze **Environment OS** without needing to know that the internal field is `userAgent.os`.

Changing a display name affects how the item is labeled in GermainUX. It does not rename the underlying field or modify the collected data.

## Configure a Display Name

Follow these steps to configure a display name:

**1. Go to Germain Workspace → Left Menu → Settings → Analytics → KPI**

**2. Select the KPI you want to configure**

**3. In the KPI Configuration Editor Right Panel, select Show Advanced**

**4. To modify an existing display name, select it from the list**

**5. Enter the internal field name and the label that users should see**

**6. Save the KPI configuration**

## Example: Rename `userAgent.os` to “Environment OS”

The following example changes the label of the `userAgent.os` field for the **User Session Replay** KPI.

**1. Go to Germain Workspace → Left Menu → Settings → Analytics → KPI**

**2. Select User Session Replay**

**3. Select Show Advanced**

**4. Select Add to open the Field Name wizard**

**5. On the Field step, enter: SettingValueField`userAgent.os`Display Name`Environment OS`**

**6. Select Finish to save the display name**

**7. Save the KPI configuration if prompted**

Users will now see **Environment OS** instead of `userAgent.os` wherever that configured display name is applied.

## Recommended Naming Practices

* Use terminology familiar to the intended business users.
* Keep labels concise and unambiguous.
* Use the same label consistently across related KPIs.
* Include units where helpful, such as **Duration (seconds)** or **Memory (MB)**.
* Avoid changing a familiar display name unless the meaning of the field has also changed.
* Confirm that the new label accurately represents the underlying data.

## Get Help

> [card] [Contact GermainUX Support](https://docs.germainux.com/main/support.md)
>
> The GermainUX team helps you get up and running faster, empower your team, turn data into actionable insights, and optimize performance to deliver measurable business outcomes.

> [card] Can't find what you need?
>
> Search all GermainUX docs with **Ctrl + K**, or use the feedback buttons at the bottom of this page to tell us what is missing.

The content of this document is proprietary to GERMAIN SOFTWARE.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.