New: Previous Provider Version Docs in Pulumi Registry

Cam Soper — Wed, 11 Mar 2026 00:00:00 +0000

The Pulumi Registry now supports browsing documentation for previous versions of first-party Pulumi providers. If you’ve ever needed to look up the API docs for an older provider version, you no longer have to dig through Git history or guess at changes — the docs are right there in the Registry. These docs also help Pulumi Neo and other agents more accurately assist you with your Pulumi code and operations.

How it works

When you visit a first-party provider’s page in the Pulumi Registry, you’ll now see a version dropdown selector that lets you switch between the current version and previous versions.

Select a previous version from the dropdown, and the Registry loads the full API documentation for that version.

What’s available

This feature currently includes documentation for the latest release of each previous major version, going back two major versions. For example, if a provider is on v7.x, you’ll be able to view docs for the latest v6.x and v5.x releases in addition to the current version.

Get started

Head over to the Pulumi Registry and try it out. Pick any first-party provider with multiple major versions and use the version dropdown to browse its history.

We’d love to hear your feedback — let us know what you think in the Pulumi Community Slack or by opening an issue on GitHub.

Explore the Pulumi Registry

Deletion Protection for Pulumi ESC Environments

Fausto Núñez Alberro — Mon, 03 Nov 2025 14:00:00 -0700

Pulumi ESC environments can now be protected from accidental deletion with a new deletion protection setting.

Environments often contain configuration that supports production workloads or is shared across multiple stacks. Deleting these environments by mistake can disrupt services and require time-consuming recovery. Deletion protection provides a safeguard against these scenarios.

How it works

When deletion protection is enabled for an environment, any attempt to delete it fails until protection is explicitly disabled. This applies to deletions from both the Pulumi Cloud console and the Pulumi CLI.

Protected environments display a shield icon in the environment list and on stack pages where the environment is imported. The icon links directly to the deletion protection settings.

Managing deletion protection

In the Pulumi Cloud console, navigate to your environment’s settings to enable or disable deletion protection with a toggle.

From the CLI, use the new pulumi env settings commands:

# Enable protection
pulumi env settings set myorg/myproject/prod deletion-protected true

# View current setting
pulumi env settings get myorg/myproject/prod deletion-protected

# Disable protection
pulumi env settings set myorg/myproject/prod deletion-protected false

Attempting to delete a protected environment returns a clear error message with instructions.

When to use deletion protection

Enable deletion protection for:

Production environments
Environments imported by multiple stacks
Environments shared across teams
Any environment containing configuration that should persist

Permissions

Only environment admins can modify deletion protection settings. This ensures that protection cannot be removed without appropriate authorization.

Getting started

Deletion protection is available now for all Pulumi ESC environments. Visit your environment settings or use the Pulumi CLI to enable it.

For more information, see the deletion protection documentation.

Pulumi Blog: Fausto Núñez Alberro

New: Previous Provider Version Docs in Pulumi Registry

How it works

What’s available

Get started

Deletion Protection for Pulumi ESC Environments

How it works

Managing deletion protection

When to use deletion protection

Permissions

Getting started