Versioning
System versioning allows builders to maintain multiple versions of a single system. A new draft version can be created by clicking the Create New Version button located next to the system name on the System Overview page.
Draft versions are not visible to end users. A version becomes visible only after it is published. Once a system version is published, it cannot be edited.
When a new version is created, it clones information from the latest version, including:
System Information
Builder Credentials
System APIs
Users can switch between system versions using the version dropdown on the System Overview page.
In the version listing, each system version is labeled with a status flag such as:
Latest Version
Currently Used Version
Deprecated Version
Deprecate A Version
Builders can deprecate a published version using the Action icon in the Version History tab.
Even after deprecation:
The system remains usable, but a warning message will be displayed.
Workflows using the deprecated version will continue to function without any issues.
Deleting a version is not currently supported.
Publish System
The Publish option is available under the Version History tab. Here, builders can find the Test and Publish button to initiate the system version publishing process.
If the Test and Publish button is disabled, please ensure that all changes in the version have been saved.
Once the Test and Publish option is clicked, a pop-up will appear requesting the following version-related details:
Version Number A unique identifier to differentiate the system version.
Examples
2.4.0 (Magento)
2025-04 (Shopify)
v2 (Bigcommerce)
Recommended Version If set to Yes, this version will be shown by default when adding the system.
Recommended Release Type Determines how the version will be upgraded.
Manual (default): The user must manually upgrade the version.
Automatic: The version is automatically upgraded after publishing.
Release Notes Builders should provide release notes or changelogs describing the changes made in this version.
After filling in the details, Builders must validate the system version by clicking the Test Connection button. Valid credentials must be provided to successfully publish the system.
Only one version can be marked as the Recommended Version.
If a new version is set as recommended, the previously recommended version will be automatically updated to No.
Last updated
Was this helpful?