Create a Microapp Instance

To create a personalized microapp you must create an instance for the microapp. The following article outlines how to create a dynamic microapp from the library and how to create an instance within your personalized microapp.

Table of Contents

1. Create a personalized instance
2. Edit an instance
3. Navigating and searching in edit-mode
4. Create personalized microapps from the Tiled API

Create a personalized instance

1. In the viewer navigation, click the chevron next to the Default Instance text
Note: If this microapp already has personalized instances you will see an instance modal with a list of instances to choose from immediately after opening the microapp.

Microapp without personalized instances Microapp with personalized instances
Screen_Shot_2022-09-08_at_6.29.46_PM.png Screen_Shot_2022-09-08_at_7.54.53_PM.png

2. A dropdown will appear and you can select Create new instance.

Modal from chevron dropdown



3. The Create new instance modal will appear and you can name your instance and click Save.
Note: You will notice the navigation bar now displays the name of your instance after you save and you can begin personalizing.

Create instance modal Navigation after personalized instance
Screen_Shot_2022-09-08_at_6.24.42_PM.png Screen_Shot_2022-09-08_at_6.26.04_PM.png

Edit an Instance

1. Click the edit icon in the top right corner of the microapp viewer.
Note: If you are a base user you will automatically be placed in edit mode. If you are an admin or editor you will see two options and will need to select Personalize.

2. You will see that the navigation bar options have changed to an "edit-mode" navigation bar. You will also see that any dynamic elements on the screen have a blue outline


3. Hover over the dynamic elements to replace them with your desired values

Tile Example Notes
Text Screen_Shot_2022-09-08_at_6.58.15_PM.png Dynamic image elements can be updated by uploading an image or pasting a URL link
Image Screen_Shot_2022-09-08_at_6.42.49_PM.png Dynamic image elements can be updated by uploading an image or pasting a URL link
Video Screen_Shot_2022-09-08_at_7.11.29_PM.png Depending on how the dynamic video was configured, users will see only one of two options when clicking the replace button.
• If the dynamic video was configured to be replaced by uploading from your device, your desktop finder will automatically appear
• If the dynamic video was configured to be replaced by pasting a video URL link, a small text field will appear for you to paste your link

1. To get to the next and previous page of the microapp use the left and right arrow buttons or navigate with the left and right arrow keys
Note: When hovering over the arrows you will see a tooltip appear indicating what page you are on out of how many are in the microapp.


2. To ensure you have updated all of the dynamic elements in this microapp, turn the View all dynamic fields toggle on
Note: Each page, state, and overlay with dynamic elements will be listed on the left side of the screen. Each page, state, and overlay will also have a blue outline with the number of dynamic elements on that screen. You will be able to update dynamic elements by selecting a screen. Once a screen is selected, a pop-over will appear with a list of the dynamic fields on that screen.

Screen_Shot_2022-09-08_at_7.21.03_PM.png Screen_Shot_2022-09-08_at_7.21.17_PM.png


3. Use the search bar to find a specific dynamic element, page, state, or overlay
Note: If there are any matches, the search bar will return a list of the following:
• A list of dynamic elements with the same name
• A list of screens containing dynamic elements with the same name
• A list of screens with the same name.



4. Once you have filled out all the dynamic fields in the microapp click Done and share your personalized instance!

Create personalized microapps from the Tiled API

It is possible to create personalized microapps from the Tiled API. The Tiled API is only available for Organizations and Enterprise accounts. See API documentation for further information.

💾 Microapps Autosave

Microapps auto-save in the browser as you update your instances or edit in the builder.



Please sign in to leave a comment.