Skip to main content
Mintlify lets you add images, videos, and other embeds directly to your documentation pages using standard Markdown image syntax or HTML tags. Store static assets in your repository and reference them with root-relative paths.

​
Markdown image syntax

Use standard Markdown to embed an image: 
![A diagram of the request lifecycle](/images/request-lifecycle.png)
The text in square brackets is the alt text — always write a meaningful description for accessibility.

​
HTML image embed

Use an <img> tag when you need to control the image dimensions: 
<img height="200" src="/images/request-lifecycle.png" alt="A diagram of the request lifecycle" />
This is useful when the default full-width rendering is too large for the content.
Mintlify supports HTML tags inside Markdown, so you can use <img>, <figure>, <picture>, and other HTML elements whenever you need more control over how media is displayed.

​
File size limit

Images stored in your repository must be 5 MB or smaller. For larger assets — such as high-resolution screenshots or diagrams — host the file on a CDN like Cloudinary or Amazon S3 and reference the external URL in your Markdown or HTML: 
![Architecture overview](https://res.cloudinary.com/your-account/image/upload/architecture.png)

​
iFrame embeds for video

Use an <iframe> tag to embed YouTube videos, Loom recordings, or other iframe-compatible content: 
<iframe
  width="560"
  height="315"
  src="https://www.youtube.com/embed/dQw4w9WgXcQ"
  title="Product walkthrough"
  frameborder="0"
  allowfullscreen
></iframe>
Replace the src value with the embed URL from your video platform. YouTube embed URLs follow the pattern https://www.youtube.com/embed/<video-id>.