diff --git a/README-ja.md b/README-ja.md
index 111f925..bb03567 100644
--- a/README-ja.md
+++ b/README-ja.md
@@ -72,6 +72,16 @@ struct ContentView: View {
 }
 ```
 
+カスタムタイトルビューでは、opacityのアニメーションのみが使用されます。iOS 26以降向けのblurとoffsetを使用したエフェクトは、文字列ベースのタイトルAPIを使用した場合にのみ有効です。
+
+### カスタムアニメーションを使用
+```swift
+.scrollAwareTitle("CustomTitle")
+.scrollAwareTitleAnimation(.spring(duration: 0.4))
+```
+
+`nil`を指定するか、`.scrollAwareTitleAnimation(_:)`を使用しない場合は、現在のOSバージョンに応じた組み込みのアニメーションが使用されます。
+
 ## ライセンス
 MIT ライセンスのもとで提供されます。
 
diff --git a/README.md b/README.md
index a4dda60..cf51202 100644
--- a/README.md
+++ b/README.md
@@ -72,8 +72,17 @@ struct ContentView: View {
 }
 ```
 
+Custom title views use the opacity animation only. The blur and offset effect for iOS 26 and later is available only when using a string-based title API.
+
+### Using a Custom Animation
+```swift
+.scrollAwareTitle("CustomTitle")
+.scrollAwareTitleAnimation(.spring(duration: 0.4))
+```
+
+Pass `nil`, or omit `.scrollAwareTitleAnimation(_:)`, to use the built-in animation selected for the current OS version.
+
 ## License
 Provided under the MIT License.
 
 vistar941 © 2026
-