---
tags:
- UI Page widgets
alias: user-guide-uipage-widgets-entity-history
widgetname: Entity History
description: "This documentation details a widget displaying an entity’s historical property changes and operations"
---

# Entity History

![entityHistory][entityHistory]

## Overview

This widget presents the history of an Entity. You can select services, which load the corresponding operations. From the operations, you can check the property changes. The operations are displayed in a nested way, which means it is possible to have multiple operations inside operations. You can also filter or search for specific operations, or just look at the service's comments in a separate tab. Below is an example of a **UI Page** with an Entity History widget, showing the history for a given **Material**.

![entityHistoryExample][entityHistoryExample]

## General Steps

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

![Screenshot showing a settings page for entity history.](images/entity_history_general.png)

## Widget Customization

1. Optionally, in the **Style** tab, you can define a Border Width and Color.

    ![Screenshot showing an Entity History style customization interface with options for border width and color.](images/entity_history_style.png)

2. In the **Setup** tab, define the Entity Type and the Entity.

    ![Screenshot showing the Entity History settings in the Setup tab of the widget customization interface.](images/entity_history_setup.png)

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

    ![Screenshot showing the "Entity History Links" section of the UI page.](images/entity_history_links.png)

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

## Real Use Case

The Entity History widget can be easily configured to receive a user selected entity from, for example, a [[user-guide-uipage-widgets-form]] widget:

![Screenshot showing a Form Widget with an entity type field.](images/image-20210519155109706.png)

1. Create a Form Widget with an entity type field as described. For more information, see [[user-guide-uipage-widgets-form]].

    ![Screenshot showing a form widget with an entity type field for creating an entity history.](images/entity_history_usecase_1.png)

2. Link the entity field to the entity History Widget.

    ![Screenshot showing a link connecting an entity field to an entity History Widget.](images/entity_history_usecase_2.png)

[entityHistory]: images/uiEntityHistory.png
[entityHistoryExample]: images/uiPageExample12.png