Add a version¶

Versioning in cTrader Store allows sellers to deliver updates, enhancements and new features while keeping a structured record of product changes.

To create a new product version, do one of the following in cTrader Windows or Mac:

• Edit the C# or Python code of your published product in the original .algo file, save it, and the changes go to cloud due to synchronisation. In cTrader Store, when updating a version, use the Select from Cloud option and fill in the necessary datails. A new version based on the changes becomes available in Store.

  Warning

  Never delete the original .algo file from your cloud storage in any cTrader app. Otherwise, you will lose access to the source code, and future versions of your product will no longer be linked to the original algorithm.

  Before editing the original .algo file in cTrader Windows or Mac, you may wish to create a local backup. Any saved changes will automatically overwrite the cloud version.

• Duplicate your initial algorithm and edit the C# or Python code in the new copy, leaving the original unchanged. Export the modified copy as an .algo file. In cTrader Store, when updating a version, use the Upload new option, upload the .algo file and fill in the necessary datails.

Update a version¶

Open Your products in your account, click the More icon for an existing product, then select Update version.

Provide the required details on the Update product version page.

• Select from Cloud – select the latest version of your product from your cloud storage.

  Warning

  If you have deleted the original algorithm from Cloud, a local file is the only way to add a new product version in the Upload new tab.

• Upload new – upload an .algo file from your device (maximum 10 MB).

• Update type – choose between a minor or major update.
• Release notes – provide information about the changes in this algorithm version.

Click the Update button once you are finished.

Versioning rules¶

Because buyers can install the latest or any previous version, they can test, compare and adopt the release that best fits their trading environment.

Consider the following best practices for version updates:

• Test thoroughly before publishing a new version to avoid bugs or other issues.
• Write clear release notes that explain the changes included in the update.
• Choose the correct version type to clearly communicate the scale of your changes.

cTrader Store supports two kinds of version increments: minor and major.

Minor versions¶

Minor updates are small changes that improve the existing behaviour of your algorithm:

• Bug fixes
• Performance optimisations
• Slight adjustments to logic
• Improvements that do not change the overall structure

Major versions¶

Major updates represent significant changes to your algorithm:

• New features
• Changes in core trading logic or strategy
• Changes in analysis methods and related operations
• Changes in risk management behaviour
• Modifications to parameters, filters and others components in ways that affect compatibility

Manage versions¶

Open Your products in your account, click the More icon for a product, then select Manage versions.

In Version history, you can review and manage all the published versions of the product.

• Archive – remove the release from the list of versions, preventing buyers from installing it.

• Unarchive – restore the release to the list of versions, allowing buyers to install it.