Update the library

This article describes how to update Advanced Charts and Trading Terminal. To do this, follow the steps below.

1. Check a library version

Check your current library version. To do this, run the following command in a browser console:

TradingView.version()

2. Review release notes

Review release notes that describe changes in a version you would like to install. If your current version is more than one release behind the desired one, you should also check release notes for the previous versions.

Pay special attention to breaking changes. These changes can cause errors and require some enhancements in your code.

3. Download a new version

Go to the Advanced Charts 🔐 or Trading Terminal 🔐 (restricted access) repository and download the latest version of the master branch.

If you want to download a version that is older than the latest, find the desired version among commits and reset the repository state to that commit.

4. Unzip an archive

When you download a ZIP archive, extract files from it to any folder you prefer. We recommend that you do not replace an old version with a new one in the existing project, but put this version in a new place. In this case, you keep a working copy that you can check with.

5. Run the new version

To test the new version, run the following command in a command line:

npx serve <PATH_TO_YOUR_FOLDER>

As a result, you get a URL that you need to copy and insert into your browser's address bar. Check the library version in a browser console to ensure you have installed the new version successfully.

6. Implement new features

Implement new features if necessary. For more information about them, refer to the dedicated documentation sections that are introduced together with the features in the release notes.

Everything that you worked on in previous versions should be compatible with the new version. However, you should always test your project on any versions you update to. If issues appear, make sure you have addressed all breaking changes.