Room configurations can be imported from JSON files, which is useful when migrating rooms between tenancies, restoring from backups, or deploying configurations shared via the Community Marketplace.
A room JSON file contains room-specific settings (device IP addresses, hostnames, credentials) that reference a parent template. The template must already exist in the target tenancy before importing the room JSON. For template imports, see Loading a Template from JSON (VC) or Loading a Template from JSON (CE).
Steps to Load a Room from JSON
- Navigate to the Rooms page by clicking Rooms in the top right of Room Manager.
- Click Add New Room to create a new room instance.
- Hover over the Options menu in the top right corner of the room window.
- Select Load Room from File from the dropdown menu.
- Upload the JSON file using one of two methods:
- Drag and drop the file into the dotted area provided.
- Click Select file from your computer to browse and select the file.
- Click Load Room to complete the upload.
The imported configuration will populate the room with all device settings, macros, and properties from the JSON file. Review the imported configuration and verify device details (IP addresses, credentials) before finalising the room.
📝 Note
If the JSON file references a template that does not exist in the current tenancy, the import will fail. Ensure the parent template has been created or imported first.