Updating Your App

When you publish a Dash app, Plotly Cloud creates a revision. Revisions are numbered and serve to distinguish one version of your app from another.

Revision #1 corresponds to the very first instance of your app being published. As you continue to improve your app, you can update the live app on Plotly Cloud by reuploading your app files, which creates a new revision.

Changing your app settings automatically creates new revisions.

You can view the history of revisions in the app Settings Plotly Cloud app Settings icon. Each revision has a status to help you track how Plotly Cloud is managing the live app. When a revision is created, Plotly Cloud attempts to build and run the app based on the uploaded files. If it is successful, the new revision changes to Running status and any previous Running revision changes to Stopped. This indicates that the new revision has replaced the earlier one as the live app.

Note

The latest revision does not always correspond to the live app. In cases where Plotly Cloud is unable to build or run the latest revision, it serves the last working revision. This means that your app remains available on Plotly Cloud even if you accidentally upload files that cause build or runtime errors.

To update your app using Plotly Cloud:

  1. Go to the app Settings Plotly Cloud app Settings icon.
  2. Select Actions > Update.

    Actions dropdown menu with the Update option highlighted

  3. Upload all the Dash app files (even those that are unchanged). Plotly Cloud runs the same checks that it runs for new apps.

  4. Select Update.

    A new revision appears in the History.

    The latest revision is in "Building" status