Skip to main contentEach time a skill is published it is assigned a version number. A skill can have multiple versions. This happens when a skill is edited and published multiple times. Skill versions allow you to have multiple variants of one skill instead of creating new skills.
In addition to the version number, each skill is also characterized by the version of its Technology Core.
Note: Before publishing a new version of a skill, check its extraction statistics. If the new version performs worse than the previous version, you may prefer not to publish the skill and use its previous version instead. To do this, go to the Skill Catalog, select the skill, and click Discard changes on the toolbar. If you have published a new version of the skill and are not satisfied with its performance, you can roll back to the previous version of the Technology Core one. For more information, see Reverting to a previous version of a Technology Core.
You can find the version number of a skill in the Version column next to the name of the skill. Click the version number to open a dialog box with information about the existing versions of the skill.
The version number of a skill is automatically incremented every time the skill is published. By default, the last three versions of the skill are always stored. This means that if there are more than three skill versions at any given time, all skill versions not being used in other skills and transactions are automatically deleted. You can disable this option by turning off the Keep 3 latest and all versions currently in use toggle. When this option is disabled, no skill versions are deleted automatically.
Editing and copying skill versions
When editing a skill, its editable version appears in the Skill Versions dialog box. A skill can only have one editable version at a time:
By default, the latest version of the skill is selected for editing. You can also manually edit any other version of a skill. To do this, click the more options icon next to the version number and select Edit skill. If you want to create a new skill instead of a new version of the current skill, select Duplicate skill.
When copying a skill, its latest version is copied by default. To copy a different version of a skill, click the copy icon or Duplicate skill next to the version number.
A derived skill can be updated if a new version of its base skill becomes available.
Importing and exporting skill versions
When importing a skill that already exists in a tenant, you can either import it as a new skill or create a new version of the existing skill. The new version of the skill will have a version number that is incremented by one from the previous version (including all versions that ever existed).
Note: A skill from another tenant is always imported with its own version number.
When exporting a skill, its latest version is exported by default. To export a different version of a skill, you must first duplicate the required version (by clicking either the copy icon or Duplicate skill next to the version number) and export it.
Skill versions in the Vantage API and Online ML
When processing a document via the Vantage API, the latest version of a skill is always used.
For a Process skill, you need to specify a particular version of the skill that will be used in Classify and Extract activities. If Online learning is enabled for the activities, these particular versions of the skills will be trained.
Deleting skill versions
You can delete any version of a skill that is not used by other skills or transactions. When you delete a skill, all of its versions are deleted. Deleted versions of skills cannot be restored.
To delete a skill version, click the delete icon next to the version number.
The deleted version number of the skill will remain stored in the system’s memory, so no new skill version will ever have a version number identical to that of a deleted skill. For example, if skill version 3, which was the latest version, is deleted, the next version of the skill would be incremented to 4. 