diff --git a/docs/3.0/upgrade.md b/docs/3.0/upgrade.md
index 013f9379..034f8e2c 100644
--- a/docs/3.0/upgrade.md
+++ b/docs/3.0/upgrade.md
@@ -51,6 +51,27 @@ field :stage,
 ```
 :::
 
+:::option Rename `link_to_resource` to `link_to_record`
+`link_to_resource` was renamed to `link_to_record`.
+::: code-group
+```ruby {3-4} [Before]
+class Avo::Resources::User < Avo::BaseResource
+  def fields
+    field :id, as: :id, link_to_resource: true
+    field :email, as: :gravatar, link_to_resource: true
+  end
+end
+```
+
+```ruby {3-4} [After]
+class Avo::Resources::User < Avo::BaseResource
+  def fields
+    field :id, as: :id, link_to_record: true
+    field :email, as: :gravatar, link_to_record: true
+  end
+end
+```
+:::
 
 ## Upgrade from 3.0.1.beta5 to 3.0.1.beta6