Manage and share a Designer App
This feature is in Beta. To use it, a workspace admin must turn on Governed agentic app-building from the Previews page. See Manage Databricks previews.
After you publish a Designer App from Lakeflow Designer, share it with app users, check its status, and keep it up to date. You can also see what app users see when they run the app, change its storage settings, and delete it. To build and publish an app, see Build and publish a Designer App.
Prerequisites
- A Designer App that you published. See Publish the app.
- To share or delete the app, you need the
CAN MANAGEpermission on the app.
Check app status
The app's status appears next to the app name and in the Apps menu in the toolbar. To see details about a status, hover over it. The following table lists the statuses:
Status | Meaning |
|---|---|
Unpublished | The app hasn't been published yet. |
Publishing | Lakeflow Designer is preparing the runner job and the app. |
Deploying | A new version of the app is deploying. |
Active | App users can open and run the app. |
Idle | The app scaled to zero after a period without use. It starts automatically when someone opens it. |
Starting, Updating, Stopping, Deleting | The app's compute is changing state. |
Stopped | The app's compute is stopped. |
Deploy failed or Error | The latest deployment failed, or the app crashed. |
Unavailable | The app's compute is active, but its status is unavailable. |
Deployment changed | The app's active deployment differs from the version that you published from this file. |
Deleted | The published app no longer exists in the workspace. |
If a deployment fails or the status is Unavailable or Deployment changed, click the arrow next to View published app, click App deployment details to see why, and then publish again. If the status is Deleted, delete the app and create a new one.
Share the app
To let someone open and run the app, grant them the CAN USE permission on the app:
- Click the arrow next to View published app, and then click App deployment details. The app's page in Databricks Apps opens.
- Click Share.
- Select a user, group, or service principal, and select CAN USE.
- Click Add, and then click Save.
Users who have the CAN MANAGE permission on the App Space can also open, run, and manage every app in it. The CAN CREATE APP and CAN READ permissions on an App Space don't let a user run an app. See Configure permissions for a Databricks app and Permissions.
App users run the visual data prep with the runner job's run-as identity, not their own. Share the app only with people who are allowed to read and write the data that it uses. See Data access and permissions.
Run the app
App users open the app URL and run it as follows:
- Set values in the form. The form appears as a row of chips. To change a value, click its chip. To upload a file, click the upload's chip and select the file.
- Click Run. While the run is in progress, the app shows its progress through the Queued, Running, and Fetching results stages.
- When the run finishes, review the results. To download a file output, click the file name.
To restore the form's defaults, click Reset next to Run. For how the form behaves, see How app users fill in the form. To stop a run, click Cancel. To view the results of an earlier run, select the run from the run list at the top of the app. The list shows each run's outcome, job run ID, and finish time. File downloads from earlier runs aren't snapshots. If a file output is set to Overwrite, each run saves its own file. If it appends or updates an Excel range, runs share one file, so an earlier run's download returns the file's latest contents.

Each app user sees only their own runs, results, and downloads. Users who have access to the runner job can see all of its runs. See View the runner job.
Update and republish the app
A published app doesn't change when you edit the visual data prep or the app. When you have unpublished changes, Lakeflow Designer shows the message You have unpublished changes. Publish to update the app.
- To update the published app, click Publish app.
- To discard your changes to the app, click Revert to published, and then click Revert. Reverting restores the app's content to match the published app. Changes to operators and charts in the visual data prep aren't affected.

If only the visual data prep or its parameter defaults changed, Lakeflow Designer shows Your Designer workflow or parameter defaults have changed since this app was published. Publish to update the app. instead. This message has no Revert to published button, because the app's own content matches the published app. To update the published app, click Publish app.
While the new version deploys, app users see This App is updating, and new runs wait until the update finishes. Renaming the app after you publish doesn't change the name of the published Databricks app.
Change app settings
To change where the app stores files, click the kebab menu next to Publish app, and then click App settings…. See Configure storage.
Changes to volumes take effect when you publish again. Existing files stay in the previous volume, and app users need to upload their files again.
You can't change the App Space after the app is created. To publish into a different App Space, create a new app.
View the runner job
Each published app has a runner job that runs the visual data prep. To view its runs and parameters, click the arrow next to View published app, and then click View job. See Monitor Lakeflow Jobs.
Delete an app
Deleting an app removes it from the visual data prep file and deletes the published Databricks app, its runner job, and its source files. You can't undo this.
- Click the kebab menu next to Publish app, and then click Delete app.
- Click Delete app to confirm.
You can't delete an app from a read-only visual data prep file.