Use versions to edit and test without impacting staging or production apps

Versions allow you to build and publish different models. A good practice is to clone the current active model to a different version of the app before making changes to the model.


This document has not been updated with text and screenshots for the latest LUIS portal.

To work with versions, open your app by selecting its name on My Apps page, and then select Manage in the top bar, then select Versions in the left navigation.

The list of versions shows which versions are published, where they are published, and which version is currently active.

Manage section, versions page

Clone a version

  1. Select the version you want to clone then select Clone from the toolbar.

  2. In the Clone version dialog box, type a name for the new version such as "0.2".

    Clone Version dialog box


    Version ID can consist only of characters, digits or '.' and cannot be longer than 10 characters.

    A new version with the specified name is created and set as the active version.

Set active version

Select a version from the list, then select Make Active from the toolbar.

Manage section, versions page, make a version action

Import version

  1. Select Import version from the toolbar.

  2. In the Import new version pop-up window, enter the new ten character version name. You only need to set a version ID if the version in the JSON file already exists in the app.

    Manage section, versions page, importing new version

    Once you import a version, the new version becomes the active version.

Import errors

Other actions

  • To delete a version, select a version from the list, then select Delete from the toolbar. Select Ok.
  • To rename a version, select a version from the list, then select Rename from the toolbar. Enter new name and select Done.
  • To export a version, select a version from the list, then select Export app from the toolbar. Choose JSON to export for backup, choose Export for container to use this app in a LUIS container.