---
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

:core-static-widgetentityhistory-lg:{style="font-size: 100px"}

## 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**.

![Entity History widget on a UI page showing the event timeline for a selected Material.](images/uiPageExample12.png)

## General

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

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

## Style

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

## Setup

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)

## Links

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)

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. Add an Entity History widget and, in the Setup tab, add the Material Entity Type:

    ![Screenshot of the Setup tab of an Entity History widget.](images/entity_history_usecase_3.png)

3. 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)