App Studio
Importing an App
Import takes an App Studio export bundle JSON and creates or updates an app in the target tenant. The importer validates the bundle schema first — if validation fails, no changes are made. Import is atomic: either the entire app is created/updated, or nothing changes.
Importing from the Admin Panel
1
Navigate to App Studio → Apps in the tenant admin panel
2
Click Import App in the top-right
3
Drop the
.appstudio.json bundle file or click Browse to select it
4
The importer validates the bundle and shows a pre-import summary: what will be created, updated, or skipped
5
Review the summary. If an app with the same
appId exists, choose the conflict strategy (see Conflict Resolution)
6
Click Import. The import runs atomically. On success, the app appears in the app list.
Create vs. Update Behavior
| Scenario | Importer behavior |
|---|---|
No app with matching appId in the tenant | Creates a new app — all pages, panes, widgets, and navigation created fresh |
App with matching appId exists | Conflict — importer asks for strategy: Replace (overwrite all) or Merge (update changed elements only) |
Import with a new appId specified | Always creates a new app — useful for cloning an app within the same tenant |
Validation Checks
The importer validates the bundle before making any changes:
schemaVersionis supported by this installation- All required fields are present in the bundle
- All
breadcrumbParentreferences resolve to pages present in the bundle - All widget
pageIdreferences resolve to pages in the bundle - No duplicate
widgetIdvalues within a pane - Token expression syntax is valid (not semantically checked — runtime errors are caught when the app runs)
If any check fails, import is rejected with a detailed error message identifying the failing element.
After Import
After a successful import:
- The app is immediately available in the App Studio app list for the target tenant
- Open the app in the designer to verify the import and make any environment-specific adjustments (e.g., data source endpoint URLs, credential IDs)
- The import is recorded in the tenant audit log: who imported, when, from which bundle version