--- title: "Add a machine widget to an app" slug: "add-a-machine-widget-to-an-app" updated: 2026-08-13T08:08:57Z published: 2026-08-13T08:08:57Z canonical: "support.tulip.co/add-a-machine-widget-to-an-app" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Add a machine widget to an app ## Purpose *Learn how to display live machine data in an app via 3 different visualizations* **In this article, you will learn...** - **How to get a real-time view of machine data in an app** Once you have [added a Machine and created an Attribute](/r230/docs/how-to-add-machine-attributes-downtime-reasons-and-states) on the Machines page, you are ready to start tracking real-time machine data. NOTE Many of the concepts in this article are also covered in detail on [Tulip University](https://university.tulip.co/learn/courses/33/machine-monitoring-in-tulip). ## How To Add a Machine Widget to an App There are three widgets that are specifically designed for machine monitoring that can display machine attributes or the status of a machine: - Machine Attribute - Machine Status - Machine Timeline ## Common configurations The first step for all machine Widgets is to select a Datasource and Machine. This connects the widgets to a specific machine or a Variable. 1. Under *Datasource,* choose *Static Value* or *Variable.* *Static Value* will allow you to pick a specific machine to display and *Variable* will allow you to change the machine based on a variable while running an App. 2. Depending on your selection in step 1, you can either select from a list of your machines or a list of your machine variables. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313487180.png) ## Machine Attribute This Widget allows you to show the current value of a single machine attribute. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313488048.png) To use, just pick the desired Attribute from the side panel. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_119733675.png) ## Machine Status This gives you a live view of the Machine's "state" as well as the last output in any of its attributes. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313490071.png) After selecting, you can determine which [Machine Activity Fields and Machine Attributes](https://support.tulip.co/docs/how-to-set-up-machine-types) you would like to view on the widget. Once your Machine Type and Attributes are selected, you can add any Activity History Fields to the widget. Commonly these include a Downtime Reason and Status. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_303049541.png) ## Machine Timeline The Machine timeline shows the status changes of a machine over a selected period of time. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313491407.png) You can choose the time range or set the start and end times manually. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313491744.png) *NOTE: only 300 data points will be shown in the timeline. If you choose a time range with more data points than this the timeline will indicate that the limit has been reached.* ### Additional Configuration Options You can toggle the following options on the Machine Timeline: - Show Key - Show Uptime Percentage - Show Header **Enable Downtime Review** When this is toggled, a button will appear that allows operators to update the Downtime Reason for any time the machine was down. ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313493540.png) ## Further Reading - [How To Use Machine Data in the Analytics Builder](https://support.tulip.co/docs/using-machine-data-in-the-analytics-editor) --- Did you find what you were looking for? You can also head to [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) to post your question or see if others have faced a similar question! **Machine** A **Machine** is a digital representation of a physical datasource. Machines have **Attributes** that are updated through an OPC-UA Connector or the Tulip API. **Widget** **Widgets** are the elements that make up a specific **App Step.** Widgets can display information to users, collect user input, or trigger app logic. *Common widgets include: Interactive Tables, Number inputs, Machine attribute widgets, and more.* **Attribute** **Attributes** are properties. In Tulip, an attribute generally references a property of a machine. Attributes can be either set points or actuals. *Ex. Cycle time, Spindle speed, Feed rate, ect.* **Widgets** **Widgets** are the elements that make up a specific **App Step.** Widgets can display information to users, collect user input, or trigger app logic. *Common widgets include: Interactive Tables, Number inputs, Machine attribute widgets, and more.* **Variable** **Variables** are a location to store app information. Variables have a specific type that must match the contents they can store. Variables are only accessible within a single application and are cleared when the app is restarted or completed. **Static Value** **Static values** are unchanging values that can be used within Triggers. Static values can be of any **Variable** type. **Machine Type** **Machine Types** are global definitions of what data to expect from machines of different types. Each Machine Type will have different states, **triggers**, and **attributes**. *EX. We have 5 makes/models of CNC mill, but they all have the same set of attributes (Spindle speed, feed rate, etc.) These can all be combined into a single "CNC Mill" Machine Type*