diff --git a/components/frames.mdx b/components/frames.mdx
index 5ba8c2e97..03d3d08cb 100644
--- a/components/frames.mdx
+++ b/components/frames.mdx
@@ -12,16 +12,28 @@ Use frames to display images, diagrams, or other visual content with consistent
 
 ## Captions
 
-You can add additional context to an image using the optional `caption` prop.
+Add additional context to an image using the optional `caption` prop. Captions appear in the frame below the image.
 
-<Frame caption="Yosemite National Park is visited by over 3.5 million people every year">
+<Frame caption="Yosemite National Park is visited by over 3.5 million people every year.">
   <img src="https://mintlify-assets.b-cdn.net/yosemite.jpg" alt="Photograph of Yosemite Valley." />
 </Frame>
 
+## Hints
+
+Add text that precedes the frame using the optional `hint` prop. Hints appear above the frame.
+
+<Frame hint="If you plan to visit Yosemite National Park, secure your permits before you go." caption="Yosemite National Park is visited by over 3.5 million people every year.">
+  <img src="https://mintlify-assets.b-cdn.net/yellowstone.jpeg" alt="Photograph of a lake surrounded by trees with mountains in the distance in Yellowstone National Park." />
+</Frame>
+
 ## Properties
 
 <ResponseField name="caption" type="string">
-  Optional caption text to show centered under your component.
+  Text that appears as part of the frame, centered below the content.
+</ResponseField>
+
+<ResponseField name="hint" type="string">
+  Text that precedes the frame.
 </ResponseField>
 
 <CodeGroup>
@@ -37,4 +49,16 @@ You can add additional context to an image using the optional `caption` prop.
   <img src="/path/image.jpg" alt="Descriptive alt text" />
 </Frame>
 ```
+
+```mdx Frame with a hint
+<Frame hint="Hint text">
+  <img src="/path/image.jpg" alt="Descriptive alt text" />
+</Frame>
+```
+
+```mdx Frame with both hint and caption
+<Frame hint="Hint text" caption="Caption text">
+  <img src="/path/image.jpg" alt="Descriptive alt text" />
+</Frame>
+```
 </CodeGroup>