> For the complete documentation index, see [llms.txt](https://kb.motion.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.motion.cloud/motion-platform-software/tiles/configuring-motion-tiles.md).
# Configuring Motion Tiles
## **Steps to Configure a Motion Tile**
### **Step 1:** Navigate to "Configure Tile" view
There are several ways to access the "Configure Tile" view for any given Motion Tile.
1. Controls > **Tile view**
2. Mosaic Dashboard
#### Tile View
The Tile view is accessible from the Controls view. This view shows a list of all Motion Tiles that have been added to the platform.
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Identifying the Motion Tile you would like to configure
Click the "Configure Tile" button
|  |
#### Mosaic Dashboard
For tiles that have been linked to a Mosaic App, you can access the tile configuration view directly from the Motion Tile itself in the Mosaic Dashboard view.
| Steps | Screenshots |
|---|
In the Mosaic Dashboard, locate the Motion Tile you wish to configure
At the top of the Motion Tile, click the tile icon to choose from additional options
|  |
| In the pop-up menu that appears, click "Configure" |  |
#### **Overview: Configuration settings**
In the configuration view, you will have the option to input settings in the following windows:
1. Basics
2. Color
3. Data Display
4. Alarms
5. Icon
6. Apps
### **Step 2:** Input Basics settings
In this window, you will:
1. Input name of Motion Tile
2. Assign the writability of the Motion Tile
#### Tile Name
| Steps | Screenshots |
| --------------------------------------------------------------- | -------------------------------- |
| Give Motion Tile a name that you will use to identify it in App |  |
#### Writability
This setting determines whether users should have the ability to change the tile's value—for example, changing the value for a thermostat setpoint tile. This setting does not define whether the underlying point actually supports writing values; rather, it merely determines whether the Motion Platform will allow a user to attempt to change the value.
Hence it is possible for a tile to be connected to a read-only device point that can never actually be physically changed by an end user (e.g. current room humidity, which is merely a reading of a current condition, not a settable value) but for this setting to be incorrectly set to "Read+Write". If this situation occurs, attempts to change the value will simply fail.
But it is also possible for the tile to be connected to a writable device point, while setting this setting to "Read-Only". This can be valuable in situations where you simply do not want an end user to have control over that point, but you want the end user to be able to monitor the current and historical values.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| If it is a "Read-Only" Tile, click the following option |  |
| If it is a "Read+Write" tile, you will select from the following additional configuration options in the lime green box:
- BACnet Priority Level
- Increment +/-
- Minimum Writable Value
- Maximum Writable Value
|  |
### **Step 3:** Assign the tile a color combination
These color combinations for individual Motion Tiles will be displayed on the user's Mosaic dashboard. Customize the color to your liking.
| Steps | Screenshots |
| --------------------------------------- | -------------------------------- |
| Select the color combination you prefer |  |
### **Step 4:** Input data output settings
This feature will display the data in the unit specified. You can also customize the amount of decimal places. In this configuration section, you will configure the following items:
1. Data Units
2. Decimal Places
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| The point on the BACnet device will be given the default data display. This, however, can be customized for display purposes. Insert the data unit that will be displayed on the Motion Tile *(Figure 6)* |  |
| Insert the amount of decimal places that you want displayed on the Motion Tile *(Figure 8)* |  |
### **Step 5:** Input data transformation settings
This configuration setting becomes necessary when a manufacturer device only displays points in a specific unit. If the unit needs to be converted, you will utilize this setting.
In this configuration section, you will configure the following items *(Figure 9)*:
1. Conversion Formula
2. Multiplier
3. Calibration Offset
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Conversion Formula: Input the type of data conversion that is needed (if applicable).
- C to F
- F to C
- kPa to psi
- psi to kPa
- I/s to CFM
- CFM to I/s
|  |
| In this section, you can choose from the following conversion formulas |  |
| In this section, you can choose from the following conversion formulas |  |
### **Step 6:** Enable/Disable Tile Alarm Conditions
#### Alarm Conditions
Alarms are a highly desired software feature provided by Motion. For every Motion Tile, you will be able to configure up to four alarm conditions*.*
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Choose up to four alarm conditions:
- High Critical
- High Warning
- Low Warning
- Low Critical
|  |
| To enable an alarm, click the purple toggle button ON/OFF for each condition as needed *(red boxes)* |  |
#### Auto-Clear Alarms
This feature was engineered for alarm management purposes.
1. **Never:** Alarm will not clear until user manually "clears" it. Alarm timestamp will be logged in Alarms view.
2. **Only When Acknowledged:** Alarm will not clear until the user "acknowledges" or "clears" the alarm. Alarm timestamp will be logged in Alarms view.
3. **Always:** Alarm will automatically clear when the tile is not longer in an alarm state. Alarm timestamp will still be logged in Alarms view. View the example provided here:
* *EXAMPLE: A user configures a tile with a high warning alarm state when the room temperature reaches/exceeds 75 degrees. Therefore, the threshold is configured for at-or-above 75 degrees. When the room temperature reaches 75 degrees, the Motion Tile will enter an alarm state and the user will be notified. In this example, assume the user selected "Always" in the Auto-clear Alarms menu. The room temperature in this area of the building reached 75 degrees, but then dropped below 75 degrees. The Motion Tile will automatically clear the alarm without the user needing to manually clear it.*
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Click from the dropdown menu and choose one of the three options discussed above (red box):
|  |
### **Step 7:** Configure Alarm Condition Settings
When the alarm condition is enabled, you will be able to select from additional alarm condition configuration options and criteria:
1. When Value is: Enter the value and operator that will trigger the alarm condition.
2. Delay Alarm For: Enter the number of seconds the value must remain continuously outside the configured threshold before the alarm is triggered. If the value returns within the acceptable range before the delay period ends, the alarm will not trigger.
3. Play Sound: Enable a sound notification that will play when the alarm condition is triggered.
4. Show Message: Enter a custom message or instructions that will appear when the alarm condition is triggered.
5. Show Icon: Select the icon that will appear when the alarm condition is triggered.
| Steps | Screenshots |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Input the above alarm condition settings |  |
{% hint style="info" %}
The alarm delay is entered in seconds. The tile value must remain continuously outside the configured threshold for the entire delay period before the alarm is triggered.
{% endhint %}
### **Step 8:** Choose a Tile Icon for your Motion Tile
For each tile, you can customize the Tile Icon for display purposes.
| Steps | Screenshots |
| ------------------------------------------------- | -------------------------------- |
| Select the icon that you wish the tile to display |  |
### **Step 9:** Link Motion Tile to one or more Motion Apps
*Preliminary Assumption: you have created a Motion App(s) that can be linked to the Motion Tile.*
For each Motion Tile you create, you will link it to one or more Motion Apps for which you want the Motion Tile to appear in.
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Click the "Manage Apps" apps button which will take you to a list of all active Motion Apps (Mosaics) on your dashboard
|  |
| Search for and select one (or more) Motion Apps for which you want to link the Motion Tile to |  |
{% hint style="info" %}
Need to create a copy of an existing tile? See [Cloning Motion Tiles](/motion-platform-software/tiles/cloning-motion-tiles.md) for instructions on cloning Numeric, Toggle, and Multi-Choice Tiles.
{% endhint %}