pulumi · CamSoper · Aug 26, 2026 · Aug 26, 2026 · Aug 26, 2026 · Aug 26, 2026
diff --git a/archetypes/templates/template/index.md b/archetypes/templates/template/index.md
@@ -51,7 +51,7 @@ and extend to suit your needs.
 To use this template to deploy your own $THING,
 make sure you've [installed Pulumi](/docs/install/)
 and [configured your $CLOUD credentials](/registry/packages/$CLOUD/installation-configuration/#credentials),
-then create a new [project](/docs/concepts/projects/) using the template in your language of choice:
+then create a new [project](/docs/iac/concepts/projects/) using the template in your language of choice:
 
 {{< templates/pulumi-new >}}
 
@@ -71,7 +71,7 @@ $ pulumi up
 ```
 
 When the deployment completes,
-Pulumi exports the following [stack output](/docs/concepts/stack/#outputs) values:
+Pulumi exports the following [stack output](/docs/iac/concepts/stacks/#outputs) values:
 
 someOutput
 : The provider-assigned property of the widget resource.
@@ -91,7 +91,7 @@ $ open $(pulumi stack output cdnURL)
 ## Customizing the project
 
 Projects created with the $ARCHITECTURE template expose
-the following [configuration](/docs/concepts/config/) settings:
+the following [configuration](/docs/iac/concepts/config/) settings:
 
 someProp
 : The description of the property. Defaults to `someValue`.

diff --git a/assets/openapi/tag-intros/stacks.md b/assets/openapi/tag-intros/stacks.md
@@ -7,4 +7,4 @@ independently configurable instances of a Pulumi program. The endpoints
 cover stack lifecycle (create, list, get, transfer, delete), stack
 configuration, stack tags, and stack update history.
 
-See [Stacks](/docs/concepts/stack/) for conceptual documentation.
+See [Stacks](/docs/iac/concepts/stacks/) for conceptual documentation.
diff --git a/content/blog/disable-default-providers/index.md b/content/blog/disable-default-providers/index.md
@@ -15,11 +15,11 @@ programmatic and dynamic control of how a resource deploys into a cloud. A Pulum
 use an explicit provider by setting the [provider resource option][prov-res-opts] or by inheriting the provider from the
 resource's [parent resource][par-res].
 
-[prov-res]: /docs/concepts/resources/providers/
-[def-prov]: /docs/concepts/resources/providers/#default-provider-configuration
-[res]: /docs/concepts/resources/
-[prov-res-opts]: /docs/concepts/options/provider/
-[par-res]: /docs/concepts/options/parent/
+[prov-res]: /docs/iac/concepts/providers/
+[def-prov]: /docs/iac/concepts/providers/#default-provider-configuration
+[res]: /docs/iac/concepts/resources/
+[prov-res-opts]: /docs/iac/concepts/resources/options/provider/
+[par-res]: /docs/iac/concepts/resources/options/parent/
 
 <!-- more -->
 
@@ -299,7 +299,7 @@ Disabling a default provider involves adding the relevant package name to the co
 `pulumi:disable-default-providers`. For example, disabling the default provider for Kubernetes and AWS would look like
 this snippet in the [configuration file][config]:
 
-[config]: /docs/concepts/projects/#stack-settings-file
+[config]: /docs/iac/concepts/projects/stack-settings-file/
 
 ```yaml
 pulumi:disable-default-providers:
@@ -321,5 +321,5 @@ accidentally relying on your system configuration. We can’t wait to find out w
 an impact on our roadmap, you can go to our [public roadmap][roadmap] and vote on issues with the rest of the community.
 Let us know what you think!
 
-[dis-def-prov]:/docs/concepts/resources/providers/#disabling-default-providers
+[dis-def-prov]:/docs/iac/concepts/providers/#disabling-default-providers
 [roadmap]:<https://github.com/orgs/pulumi/projects/44>
diff --git a/content/blog/pulumi-kubernetes-operator/index.md b/content/blog/pulumi-kubernetes-operator/index.md
@@ -670,6 +670,6 @@ with users and the Pulumi team.
 [pulumi-k8s-nginx]: https://github.com/pulumi/examples/tree/master/kubernetes-ts-nginx/
 [pulumi-aws-eks]: https://github.com/metral/pulumi-aws-eks/
 [p-examples]: https://github.com/pulumi/examples/
-[stack]: /docs/concepts/stack/
-[pulumi-config]: /docs/concepts/config/
+[stack]: /docs/iac/concepts/stacks/
+[pulumi-config]: /docs/iac/concepts/config/
 [pulumi-providers]: /registry/
diff --git a/content/docs/iac/concepts/programming-model-previous.md b/content/docs/iac/concepts/programming-model-previous.md
@@ -9,6 +9,6 @@ block_external_search_index: true
     waiting a few seconds before redirecting gives the script (see redirects.ts) a chance
     to locate a matching anchor.
 -->
-<meta http-equiv="refresh" content="4; url=/docs/concepts">
+<meta http-equiv="refresh" content="4; url=/docs/iac/concepts/">
 
 This content has moved. Redirecting to [Pulumi Concepts](/docs/iac/concepts/)....
diff --git a/content/docs/iac/concepts/programming-model.md b/content/docs/iac/concepts/programming-model.md
@@ -9,6 +9,6 @@ block_external_search_index: true
     waiting a few seconds before redirecting gives the script (see redirects.ts) a chance
     to locate a matching anchor.
 -->
-<meta http-equiv="refresh" content="4; url=/docs/concepts">
+<meta http-equiv="refresh" content="4; url=/docs/iac/concepts/">
 
 This content has moved. Redirecting to [Pulumi Concepts](/docs/iac/concepts/)....
diff --git a/content/docs/iac/concepts/resources/_index.md b/content/docs/iac/concepts/resources/_index.md
@@ -22,33 +22,33 @@ aliases:
     // We use this list to determine whether we can redirect visitors from the old content to the new.
     var redirects = {
         "#options": "/docs/iac/concepts/resources/options/",
-        "#additionalsecretoutputs": "/docs/iac/concepts/resources/options/additionalsecretoutputs",
-        "#aliases": "/docs/iac/concepts/resources/options/aliases",
-        "#customtimeouts": "/docs/iac/concepts/resources/options/customtimeouts",
-        "#deletebeforereplace": "/docs/iac/concepts/resources/options/deletebeforereplace",
-        "#dependson": "/docs/iac/concepts/resources/options/dependson",
-        "#ignorechanges": "/docs/iac/concepts/resources/options/ignorechanges",
-        "#import": "/docs/iac/concepts/resources/options/import",
-        "#parent": "/docs/iac/concepts/resources/options/parent",
-        "#protect": "/docs/iac/concepts/resources/options/protect",
-        "#provider": "/docs/iac/concepts/resources/options/provider",
-        "#replaceonchanges": "/docs/iac/concepts/resources/options/replaceonchanges",
-        "#transformations": "/docs/iac/concepts/resources/options/transformations",
-        "#transforms": "/docs/iac/concepts/resources/options/transforms",
-        "#version": "/docs/iac/concepts/resources/options/version",
-        "#components": "/docs/concepts/resources/components",
+        "#additionalsecretoutputs": "/docs/iac/concepts/resources/options/additionalsecretoutputs/",
+        "#aliases": "/docs/iac/concepts/resources/options/aliases/",
+        "#customtimeouts": "/docs/iac/concepts/resources/options/customtimeouts/",
+        "#deletebeforereplace": "/docs/iac/concepts/resources/options/deletebeforereplace/",
+        "#dependson": "/docs/iac/concepts/resources/options/dependson/",
+        "#ignorechanges": "/docs/iac/concepts/resources/options/ignorechanges/",
+        "#import": "/docs/iac/concepts/resources/options/import/",
+        "#parent": "/docs/iac/concepts/resources/options/parent/",
+        "#protect": "/docs/iac/concepts/resources/options/protect/",
+        "#provider": "/docs/iac/concepts/resources/options/provider/",
+        "#replaceonchanges": "/docs/iac/concepts/resources/options/replaceonchanges/",
+        "#transformations": "/docs/iac/concepts/resources/options/transformations/",
+        "#transforms": "/docs/iac/concepts/resources/options/transforms/",
+        "#version": "/docs/iac/concepts/resources/options/version/",
+        "#components": "/docs/iac/concepts/components/",
         "#authoring-a-new-component-resource": "/docs/iac/guides/building-extending/components/build-a-component/",
         "#creating-child-resources": "/docs/iac/guides/building-extending/components/build-a-component/#creating-child-resources",
         "#registering-component-outputs": "/docs/iac/guides/building-extending/components/build-a-component/#registering-component-outputs",
         "#inheriting-resource-providers": "/docs/iac/guides/building-extending/components/build-a-component/#inheriting-resource-providers",
-        "#providers": "/docs/iac/concepts/providers",
+        "#providers": "/docs/iac/concepts/providers/",
         "#default-provider-configuration": "/docs/iac/concepts/providers/#default-provider-configuration",
         "#explicit-provider-configuration": "/docs/iac/concepts/providers/#explicit-provider-configuration",
-        "#dynamicproviders": "/docs/iac/concepts/providers/dynamic-providers",
-        "#names": "/docs/concepts/resources/names",
-        "#autonaming": "/docs/concepts/resources/names/#autonaming",
-        "#urns": "/docs/concepts/resources/names/#urns",
-        "#resource-get": "/docs/concepts/resources/get",
+        "#dynamicproviders": "/docs/iac/concepts/providers/dynamic-providers/",
+        "#names": "/docs/iac/concepts/resources/names/",
+        "#autonaming": "/docs/iac/concepts/resources/names/#autonaming",
+        "#urns": "/docs/iac/concepts/resources/names/#urns",
+        "#resource-get": "/docs/iac/concepts/functions/get-functions/",
     };
 
     var redirect = redirects[location.hash];

diff --git a/content/docs/iac/guides/clouds/aws/eks.md b/content/docs/iac/guides/clouds/aws/eks.md
@@ -304,7 +304,7 @@ it using Pulumi into our EKS cluster with the following code and by running `pul
 {{< example-program path="aws-eks-k8s-configgroup" >}}
 
 The `ConfigFile` and `ConfigGroup` classes support [`transforms`](
-/docs/concepts/options/transforms/) via `ResourceOptions`, which can be used to ['monkey patch'](
+/docs/iac/concepts/resources/options/transforms/) via `ResourceOptions`, which can be used to ['monkey patch'](
 https://en.wikipedia.org/wiki/Monkey_patch) Kubernetes configuration on the fly. This can be used to rewrite
 configuration to include additional services (like Envoy sidecars), inject tags, and so on.
 

diff --git a/content/docs/insights/discovery/search.md b/content/docs/insights/discovery/search.md
@@ -443,5 +443,5 @@ More specifically:
 - If an organization has a default permission of read or write, then all users can query all resources.
 - If an organization has no default permission, then users can only query resources they have access to via [Stack](/docs/administration/concepts/rbac/permission-sets/#stack-permission-sets) or [Team](/docs/administration/concepts/rbac/teams/#team-access-types) permissions.
 
-[types]: /docs/concepts/resources/names/#types
-[urn]: /docs/concepts/resources/names/#urns
+[types]: /docs/iac/concepts/resources/names/#types
+[urn]: /docs/iac/concepts/resources/names/#urns
diff --git a/content/docs/integrations/clouds/kubernetes/pulumi-kubernetes-operator/_index.md b/content/docs/integrations/clouds/kubernetes/pulumi-kubernetes-operator/_index.md
@@ -34,7 +34,7 @@ The Pulumi Kubernetes Operator provides [custom resources][k8s-ext-pattern] to:
 Deploying Pulumi stacks using Kubernetes provides the capability to build out CI/CD and other automation systems, and to manage your infrastructure alongside your Kubernetes workloads or in dedicated control-plane clusters.
 
 [k8s-ext-pattern]: https://kubernetes.io/docs/concepts/extend-kubernetes/operator/
-[stack]: /docs/concepts/stack/
+[stack]: /docs/iac/concepts/stacks/
 [Pulumi YAML]: /docs/iac/languages-sdks/yaml/
 
 ## In this section

diff --git a/layouts/migrate/terraform.html b/layouts/migrate/terraform.html
@@ -11,7 +11,7 @@ <h2>The open source infrastructure as code platform</h2>
                     <p>
                         Pulumi is fully open source while Terraform is committed to the Business Source License, a restrictive source available license.
                         Pulumi lets you choose the approach that fits your team — general-purpose programming languages, YAML, or HashiCorp Configuration Language (HCL) — to tame cloud complexity and accelerate development velocity.
-                        See our <a href="/docs/concepts/vs/terraform">Pulumi vs. Terraform guide</a> for detailed differences between the two platforms.
+                        See our <a href="/docs/iac/comparisons/terraform/">Pulumi vs. Terraform guide</a> for detailed differences between the two platforms.
                     </p>
                     <p>
                         Migrate off of Terraform to a more modern and open source infrastructure as code platform.

diff --git a/scripts/search/rank.js b/scripts/search/rank.js
@@ -77,15 +77,10 @@ module.exports = {
         if (page.href.startsWith("/docs")) {
 
             // First concepts.
-            if (page.href.startsWith("/docs/concepts/")) {
+            if (page.href.startsWith("/docs/iac/concepts/")) {
                 return 890;
             }
 
-            // Then using.
-            if (page.href.startsWith("/docs/using-pulumi/")) {
-                return 880;
-            }
-
             // Top-level pages again rank highest.
             if (page.kind === "section") {
                 return 870

diff --git a/theme/src/ts/redirects.ts b/theme/src/ts/redirects.ts
@@ -5,40 +5,40 @@ if (path === "/docs/intro/concepts/programming-model/" || path === "/docs/refere
     // The following list maps the headings that previously appeared on these pages to their new locations.
     // We use this list to determine whether we can redirect visitors from the old content to the new.
     let redirects = {
-        "#additionalsecretoutputs": "/docs/concepts/resources/#additionalsecretoutputs",
-        "#aliases": "/docs/concepts/resources/#aliases",
-        "#all": "/docs/concepts/inputs-outputs/#all",
-        "#apply": "/docs/concepts/inputs-outputs/#apply",
-        "#assets-and-archives": "/docs/concepts/assets-archives/",
-        "#autonaming": "/docs/concepts/resources/#autonaming",
-        "#components": "/docs/concepts/resources/#components",
-        "#config": "/docs/concepts/config",
-        "#custom-resources": "/docs/concepts/resources/#custom-resources",
-        "#declaring-infrastructure": "/docs/concepts/#overview",
-        "#deletebeforereplace": "/docs/concepts/resources/#deletebeforereplace",
-        "#dependson": "/docs/concepts/resources/#dependson",
-        "#dynamicproviders": "/docs/concepts/resources/#dynamicproviders",
-        "#explicit-provider-configuration": "/docs/concepts/resources/#explicit-provider-configuration",
-        "#import": "/docs/concepts/resources/#import",
-        "#introduction": "/docs/intro/concepts",
-        "#lifting": "/docs/concepts/inputs-outputs/#lifting",
-        "#names": "/docs/concepts/resources/#names",
-        "#outputs": "/docs/concepts/inputs-outputs",
-        "#outputs-and-strings": "/docs/concepts/inputs-outputs/#outputs-and-strings",
-        "#program-structure": "/docs/concepts/#overview",
-        "#programs": "/docs/concepts/#overview",
-        "#providers": "/docs/concepts/resources/#providers",
-        "#reading-configuration-values": "/docs/concepts/config/#code",
-        "#resource-get": "/docs/concepts/resources/#resource-get",
-        "#resource-providers": "/docs/concepts/resources/#providers",
-        "#resourceoptions": "/docs/concepts/resources/#options",
-        "#resources": "/docs/concepts/resources",
-        "#runtime": "/docs/concepts/",
-        "#runtime-functions": "/docs/concepts/",
-        "#secrets": "/docs/concepts/secrets",
-        "#stack-outputs": "/docs/concepts/stack/#outputs",
-        "#stack-references": "/docs/concepts/stack/#stack-references",
-        "#transformations": "/docs/concepts/resources/#transformations",
+        "#additionalsecretoutputs": "/docs/iac/concepts/resources/options/additionalsecretoutputs/",
+        "#aliases": "/docs/iac/concepts/resources/options/aliases/",
+        "#all": "/docs/iac/concepts/inputs-outputs/all/",
+        "#apply": "/docs/iac/concepts/inputs-outputs/apply/",
+        "#assets-and-archives": "/docs/iac/concepts/assets-archives/",
+        "#autonaming": "/docs/iac/concepts/resources/names/#autonaming",
+        "#components": "/docs/iac/concepts/components/",
+        "#config": "/docs/iac/concepts/config/",
+        "#custom-resources": "/docs/iac/concepts/resources/",
+        "#declaring-infrastructure": "/docs/iac/concepts/",
+        "#deletebeforereplace": "/docs/iac/concepts/resources/options/deletebeforereplace/",
+        "#dependson": "/docs/iac/concepts/resources/options/dependson/",
+        "#dynamicproviders": "/docs/iac/concepts/providers/dynamic-providers/",
+        "#explicit-provider-configuration": "/docs/iac/concepts/providers/#explicit-provider-configuration",
+        "#import": "/docs/iac/concepts/resources/options/import/",
+        "#introduction": "/docs/iac/concepts/",
+        "#lifting": "/docs/iac/concepts/inputs-outputs/apply/#using-lifting-to-simplify-nested-access",
+        "#names": "/docs/iac/concepts/resources/names/",
+        "#outputs": "/docs/iac/concepts/inputs-outputs/",
+        "#outputs-and-strings": "/docs/iac/concepts/inputs-outputs/all/#using-string-interpolation",
+        "#program-structure": "/docs/iac/concepts/",
+        "#programs": "/docs/iac/concepts/",
+        "#providers": "/docs/iac/concepts/providers/",
+        "#reading-configuration-values": "/docs/iac/concepts/config/#code",
+        "#resource-get": "/docs/iac/concepts/functions/get-functions/",
+        "#resource-providers": "/docs/iac/concepts/providers/",
+        "#resourceoptions": "/docs/iac/concepts/resources/options/",
+        "#resources": "/docs/iac/concepts/resources/",
+        "#runtime": "/docs/iac/concepts/",
+        "#runtime-functions": "/docs/iac/concepts/",
+        "#secrets": "/docs/iac/concepts/secrets/",
+        "#stack-outputs": "/docs/iac/concepts/stacks/#outputs",
+        "#stack-references": "/docs/iac/concepts/stacks/#stackreferences",
+        "#transformations": "/docs/iac/concepts/resources/options/transformations/",
     };
 
     var redirect = redirects[location.hash];

diff --git a/theme/src/ts/toc.ts b/theme/src/ts/toc.ts
@@ -3,7 +3,7 @@ document.addEventListener("DOMContentLoaded", function () {
         "/docs/get-started/": "get-started-with-pulumi-toc-header",
         "/docs/": "intro-toc-header",
         "/docs/using-pulumi/": "user-guides-toc-header",
-        "/docs/concepts/": "reference-toc-header",
+        "/docs/iac/concepts/": "reference-toc-header",
         "/docs/support/": "support-toc-header",
         "/docs/iac/adopting-pulumi/converters/": "converters-toc-header",
     };