diff --git a/website/docs/index.html.markdown b/website/docs/index.html.markdown
index 01b5d7d374..97002c65db 100644
--- a/website/docs/index.html.markdown
+++ b/website/docs/index.html.markdown
@@ -50,6 +50,7 @@ resource "github_membership" "membership_for_user_x" {
   # ...
 }
 ```
+~> **Note:** When upgrading from `hashicorp/github` to `integrations/github`, use `terraform state replace-provider`. Otherwise, Terraform will still require the old provider to interact with the state file.
 
 ## Authentication