Stay organized with collections Save and categorize content based on your preferences.
A version is a static copy of a script. Versions let you track your changes. Once you save a version, you can't modify it. Use versions when you're working on a script that goes through many changes and iterations. Script projects can have up to 200 versions.
Creating versions is required when you're writing a library. For more information, see Libraries.
Create a version
A version is automatically created when you create a new deployment. You can also create a new version from an existing deployment by taking the following steps:
Open your script project.
At the top, click Deploy>Manage deployments.
Select the active deployment to create a new version for and click Edit edit.
In the Version section, select New version.
Click Deploy.
View a previous version
To view a previously created version within your script project, take the following steps:
In your script project, click historyProject History.
Under Project history, select the version you want to view. To view the description of a version, hold the pointer over the version number.
Compare a previous version to the current version
To compare a previously created version to the current, or head, version, take the following steps:
In your script project, click historyProject History.
Under Project history, select the version you want to view.
Turn on Highlight changes.
Depending on the changes you've made since the selected version, the files list might contain the following markers:
Marker
Type of change
Description
File added
This file is new in the current version.
File deleted
This file is no longer present in the current version.
File modified
This file has changes in the current version that weren't present in the selected version. To view the changes, click the file name.
Restore a version
In your script project, click historyProject History.
Next to the version you want to restore, click more_vertMore actions>Restore this version>Restore.
Delete versions
You can permanently delete versions if they're not in use by an active deployment. To archive a deployment or change the version that an active deployment uses, refer to Create and manage deployments.
Delete a version
To delete one version at a time, take the following steps:
In your script project, click historyProject History.
Next to the version you want to delete, click more_vertMore actions>Delete this version>Delete.
Delete multiple versions at once
To delete multiple versions at the same time, take the following steps:
In your script project, click historyProject History.
Click Bulk delete versions. A dialog shows a list of versions that you can delete. Versions in use by an active deployment aren't included in the list.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-18 UTC."],[[["\u003cp\u003eVersions in Apps Script are static copies of your script, allowing you to track changes and revert to previous states if necessary.\u003c/p\u003e\n"],["\u003cp\u003eCreating versions is essential for libraries and projects undergoing frequent modifications, providing a history of your script's development.\u003c/p\u003e\n"],["\u003cp\u003eYou can easily create, view, compare, and delete versions within your Apps Script project using the provided steps.\u003c/p\u003e\n"],["\u003cp\u003eA maximum of 200 versions can be stored per script project, offering ample space for tracking your progress.\u003c/p\u003e\n"],["\u003cp\u003eVersions in use by active deployments cannot be deleted, ensuring that your deployed scripts remain functional.\u003c/p\u003e\n"]]],[],null,["A version is a static copy of a script. Versions let you track your\nchanges. Once you save a version, you can't modify it. Use versions when you're\nworking on a script that goes through many changes and iterations. Script\nprojects can have up to 200 versions.\n\nCreating versions is required when you're writing a library. For more\ninformation, see [Libraries](https://developers.google.com/apps-script/guides/libraries.html#creating-a-library).\n\nCreate a version\n\nA version is automatically created when you create a new deployment. You can\nalso create a new version from an existing deployment by taking the following\nsteps:\n\n1. Open your script project.\n2. At the top, click **Deploy** \\\u003e **Manage\n deployments**.\n3. Select the active deployment to create a new version for and click Edit edit.\n4. In the **Version** section, select **New version**.\n5. Click **Deploy**.\n\nView a previous version\n\nTo view a previously created version within your script project, take the\nfollowing steps:\n\n1. In your script project, click history **Project History**.\n2. Under **Project history**, select the version you want to view. To view the description of a version, hold the pointer over the version number.\n\nCompare a previous version to the current version\n\nTo compare a previously created version to the current, or head, version, take\nthe following steps:\n\n1. In your script project, click history **Project History**.\n2. Under **Project history**, select the version you want to view.\n3. Turn on **Highlight changes**.\n\nDepending on the changes you've made since the selected version, the files list\nmight contain the following markers:\n\n| Marker | Type of change | Description |\n|--------|----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| | File added | This file is new in the current version. |\n| | File deleted | This file is no longer present in the current version. |\n| | File modified | This file has changes in the current version that weren't present in the selected version. To view the changes, click the file name. |\n\nRestore a version\n\n1. In your script project, click history **Project History**.\n2. Next to the version you want to restore, click more_vert **More actions** \\\u003e **Restore this version** \\\u003e **Restore**.\n\nDelete versions\n\nYou can permanently delete\nversions if they're not in use by an active deployment. To archive a deployment\nor change the version that an active deployment uses,\nrefer to [Create and manage deployments](/apps-script/concepts/deployments).\n\nDelete a version\n\nTo delete one version at a time, take the following steps:\n\n1. In your script project, click history **Project History**.\n2. Next to the version you want to delete, click more_vert **More actions** \\\u003e **Delete this version** \\\u003e **Delete**.\n\nDelete multiple versions at once\n\nTo delete multiple versions at the same time, take the following steps:\n\n1. In your script project, click history **Project History**.\n2. Click **Bulk delete versions**. A dialog shows a list of versions that you can delete. Versions in use by an active deployment aren't included in the list.\n3. Select the versions to delete and click **Delete**.\n4. In the dialog, click **Delete**."]]