# Configuring a Mosaic App
## Prerequisites
Before configuring a Mosaic App, the following perquisites must be satisfied:
1. You've already added a Mosaic App to configure
2. You have discovered or added device points to the Cloud
3. The device you added supports BACnet
4. The BACnet device is connected to the same local area network as the Motion Hub with which it is associated
## **Configuring App Settings**
### **Step 1:** Open the Mosaic App that you wish to configure
Using the search bar, type in the name of the Mosaic App you have already added. Users can find a Mosaic App in two separate views:
1. Apps
2. Manage Apps
| Views | Screenshots |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search for the Motion App you'd like to configure in the Apps view |  |
| Search for the Motion App you'd like to configure in the Manage Apps view |  |
### **Step 2:** Click the Configuration menu option
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click the "Configuration" option on the left-hand vertical menu to access the Configuration view |  |
### **Step 3:** Input details in App Settings
Click the "App Settings" view. You are able fill in the following inputs:
1. Name
2. Subtitle
3. Weather Postal Code
4. App Image
| App Setting Windows | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name
Input the desired name of the App to easily identify it.
This will be the name that you see appear in the Motion Apps view.
Click "Save"
|  |
| Subtitle
If desired, input a subtitle to further identify the App
This will be the subtitle that you see appear on the Motion Apps view
Click "Save"
|  |
| Weather Postal Code
A user's Motion App can have a weather postal code associated with it if desired (Figure 6). This will link the app with local weather information.
Input the postal code associated with the site location
Click "Save"
|  |
| App Image
If desired, give the Mosaic App an image which will be displayed in the Apps view.
Save image file to desktop
Click "Upload File" button
Locate and open image from saved files
|  |
## **Configuring Tiles & Tile Groups**
### **Step 1:** Click on "Tile Groups" to configure dashboard layout
These configuration settings allows you to organize and group Motion Tiles in a way that is preferred by the user. In the steps below, we are going to discuss the following dashboard configuration options/topics:
1. Ungrouped Tiles
2. Creating a new Tile Group
3. Adding Ungrouped Motion Tiles to a newly created Tile Group
4. Relocating a Motion Tile from one Tile Group to another Tile Group
5. Repositioning Motion Tiles within a single Tile Group
6. Shuffling Tile Groups around
### **Step 2:** Identify Ungrouped Tiles
When a new Motion Tile is created and linked to a Motion App, the Motion Tile will, by default, display at the top of the Mosaic Dashboard. These are considered **"Ungrouped Tiles".** They do not have a group name assigned to it.
In the same manner, new Motion Tiles will, by default, display at the top of the "Tile Group" view in the configuration settings as "Ungrouped tiles".
These ungrouped Motion Tiles will stay ungrouped until they are assigned to a tile group.
| Ungrouped Tiles | Screenshots |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mosaic Dashboard view |  |
| Tile Groups view |  |
### **Step 3:** Create a new Tile Group
In the steps below, we will show users how to create a new Tile Group to group the ungrouped Motion Tiles discussed above. In this example, we are going to name this new Tile Group "Refrigeration".
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| To create a new Tile Group, locate and click the green "Add Group" button at the top of the page |  |
| When this button is clicked, a new Tile Group will appear at the bottom of the Tile Group list. The default name of the tile group you created reads "New Group"
Locate the newly created Tile Group at the bottom of the view (red box)
Give the Tile Group a name (lime green box)
|  |
### **Step 4a:** Add Motion Tiles to a Tile Group
*Preliminary Assumption: You are grouping Motion Tiles that have already been linked to this Mosaic App.*
Next to each Motion Tile, you will identify the blue chocolate bar icon*.*
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click the blue chocolate bar icon (red box), and drag the Motion Tile into a Tile Group of your choice. Repeat for all other tiles that need to be grouped.
NOTE: You can use this same method to move individual Motion Tiles from one Tile Group to another.
Click the "Save" button at bottom of page to save your configuration changes.
|  |
| In this example, we added all eight of the ungrouped tiles to the newly created Tile Group, which we have labeled "Refrigeration".
As you can see, there exist no tiles to click and drag from the "Ungrouped Tiles" at the top of the page (Figure 13)
|  |
### **Step 4b:** Add Motion Tiles to a Tile Group from another Mosaic App
*Preliminary Assumption: You are grouping Motion Tiles that have already been created but do **NOT** exist in this Mosaic App*
Alternatively, you can add Motion Tiles from another Mosaic App to a Tile Group by clicking the "Add Tiles" button that appears at the bottom left corner of each Tile Group.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Click "Add Tiles" button (red box)
Type in the tile name or tile ID in the pop-up search window that appears (lime green box)
|  |
### **Step 5 (Optional):** Follow instructions for additional configuration options
You have successfully created a Tile Group and added the ungrouped Motion Tiles to this Tile Group. Now, you can select from additional configuration settings for the Mosaic dashboard.
1. Repositioning tile groups
2. Deleting tiles from Mosaic App
3. Ungrouping tiles
#### Repositioning Tile Groups
For organizational preferences, you may want to reposition the order of the Tile Groups. The order of the Tile Groups from top-to-bottom in this configuration view will be reflected in the order of the Tile Groups that are displayed from top-to-bottom on the Mosaic Dashboard view.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Locate the Tile Group you wish to reposition
Click the black chocolate bar icon next to the title of the Tile Group (red box)
Click and drag the selected Tile Group to a placement of your liking
Click the "Save" button at bottom of page
|  |
#### Deleting Motion Tiles from Mosaic App
You have the option to delete individual Motion Tiles completely from the Mosaic App. This will unlink the Motion Tile from this Mosaic App.
| Steps | Screenshots |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| At the right hand side of the view, click the red "X" icon |  |
#### Ungrouping Motion Tiles
Users have the ability to delete a Tile Group. This consequently ungroups each individual Motion Tile that was in that deleted group. After deleting a Tile Group, the ungrouped tiles will reappear at the top of the view.
| Steps | Screenshots |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Locate and click the red Group "X" icon |  |
### **Step 8:** Save Configuration Changes
Your changes will not be reflected in the Mosaic Dashboard view unless you save them.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| When your configuration settings are complete, click the save button at the bottom of the view *(lime green box)* |  |
| NOTE: If you accidentally made configuration changes that were not meant to be saved, you can start over by clicking the "Revert" button at the bottom of the page *(red box)* |  |