Manage extensions

After you publish your extension, you can modify and update it at any time.

Take advantage of continuous deployment on Netlify

To simplify releasing extension updates, we recommend that you enable continuous deployment for the Netlify site that hosts your extension code. To enable continuous deployment, make sure your site is linked to your Git repository. Once linked, a push to the production branch of your repository will trigger a new site deploy on Netlify.

Update and release extension versions

All published extensions are hosted on a Netlify site. This means you can take advantage of Netlify’s concept of atomic deploys and update your extension using new site deploys.

Every time you publish a new deploy for the site that hosts your extension, your published extension will update automatically. Remember to update the details.md in your repository to reflect any important information for your users whenever you release a new version.

To update your extension:

Commit and push your code to the production branch of your Git repository.
If the Netlify site that contains your extension code is linked to your Git repository and you have auto publishing enabled, Netlify will automatically create a new site deploy based on the push to the production branch of your repository.

If your site is not linked, you can link it now. Alternatively, you can manually deploy your site with the Netlify CLI.

If your site is locked to a specific deploy, you can unlock to start auto publishing.

Once the deploy is complete, your extension is up to date. The latest version of your extension will be available to all teams that have it installed. Depending on what your extension does, users may need to rebuild and redeploy their sites to run the latest version of your extension.

Learn more about site deploys in the Netlify user docs.

Edit extension settings

As a Team Owner, you can edit metadata and settings for a published extension in the Netlify UI.

Warning

Once you make an extension public, it is not possible to change the visibility back to private.

To update the extension settings or metadata, navigate to the extension’s details page in the Netlify UI:

Navigate to your team’s Extensions page.
Select Created by your team.
Find your extension and select it.
On the extension’s details page, select Manage.
Update the fields as needed and then select Update.

Edit extension details

We use the details.md file in your extension codebase to populate the Details section of the extension’s details page. This gives you full control of the in-app documentation for your users.

To update the details section:

Update the details.md file and commit the change to the production branch of your Git repository.
If the Netlify site that contains your extension code is linked to your Git repository and you have auto publishing enabled, Netlify will automatically create a new site deploy based on the push to the production branch of your repository.

If your site is not linked, you can link it now. Alternatively, you can manually deploy your site with the Netlify CLI.

If your site is locked to a specific deploy, you can unlock to start auto publishing.

Once the deploy is complete, your extension details will be up to date.

Delete an extension

As a Team Owner, you can delete an extension if it is private and if it is not currently installed on a team.

Note that this action cannot be reversed.

To delete your extension:

Navigate to your team’s Extensions page.
Select Created by your team.
Find your extension and select it.
On the extension’s details page, select Manage.
Under Danger zone, select Delete this extension.
Review the prompt and select Delete to confirm.

If you need to delete an extension that is public or an extension that is private but installed on a team, please contact us for support.

Got it!

Your feedback helps us improve our docs.