Skip to main content
The Terraform Plugin SDK (SDKv2) is the legacy SDK for building Terraform providers. Its documentation covers provider schema definitions, resource lifecycle, acceptance testing, and migration guidance to the Plugin Framework. It is versioned and stored in content/terraform-plugin-sdk/. The content API uses the terraform product slug. The navDataPath for this directory is plugin-sdkv2, and content is served under the /plugin/sdkv2/ URL base path.
For new provider development, HashiCorp recommends using the Terraform Plugin Framework instead of the Plugin SDK. The Plugin SDK remains supported for existing providers.

Content directory

content/terraform-plugin-sdk/
├── v2.15.x/
├── v2.16.x/
├── v2.17.x/
├── v2.18.x/
├── v2.19.x/
├── v2.20.x/
├── v2.21.x/
├── v2.22.x/
├── v2.23.x/
├── v2.24.x/
├── v2.25.x/
├── v2.26.x/
├── v2.27.x/
├── v2.28.x/
├── v2.29.x/
├── v2.30.x/
├── v2.31.x/
├── v2.32.x/
├── v2.33.x/
├── v2.34.x/
├── v2.35.x/
├── v2.36.x/
├── v2.37.x/
├── v2.38.x/
└── v2.39.x/
Each version directory follows the standard structure:
content/terraform-plugin-sdk/<version>/
├── docs/            # Markdown content files
├── data/            # Navigation sidebar JSON files
└── img/             # Image assets

URL base paths

Terraform Plugin SDK content is served under /plugin/sdkv2/.

Available versions

Versions v2.15.x through v2.39.x are present in the repository.
Older versions (v2.15.x and earlier) may fail migration scripts with errors indicating missing img/, docs/, or data/ directories. Confirm the directory structure before editing older versions.

Finding and editing Plugin SDK docs

1

Find the version directory

List the available version directories:
ls content/terraform-plugin-sdk/
2

Navigate to the content files

Content files are in the docs/ subdirectory within each version folder:
ls content/terraform-plugin-sdk/v2.39.x/docs/
3

Edit the file

Open the .mdx file you want to change.
4

Update navigation if needed

Navigation sidebar data is in content/terraform-plugin-sdk/<version>/data/.

Product configuration reference

AttributeValue
productSlugterraform
navDataPathplugin-sdkv2
contentDirdocs (in source repo)
websiteDirwebsite (in source repo)
dataDirdata
assetDirimg
basePathsplugin/sdkv2
versionedDocstrue

Build docs developers (and LLMs) love