Skip to content

docs: note 50 MB media upload limit in editor #5870

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: note 50 MB media upload limit in editor #5870

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
be42801
docs: note 50 MB media upload limit in editor
mintlify[bot] May 20, 2026
e6a2e56
docs: mirror 50 MB media upload note to es and fr
mintlify[bot] May 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions editor/pages.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
- **Link to another page**: Right-click a page in the navigation tree, click **Copy link**, then paste the link into your content. The editor recognizes internal links to other pages and converts them.
- **Insert media from your project**: Drag an image or video from the navigation tree into the page to embed it inline. Supported formats include PNG, JPG, JPEG, GIF, WebP, SVG, MP4, and WebM.
- **Insert an emoji**: Type <kbd>:</kbd> followed by a keyword to open the emoji picker.
- **Edit a table**: When your cursor is inside a table, use the floating toolbar to add or remove rows and columns, or merge cells.

Check warning on line 36 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L36 

Use 'Cursor' instead of 'cursor'.

**Markdown mode** gives you direct access to the MDX source. Use it for precise control over component properties and frontmatter.

Expand All @@ -58,7 +58,7 @@

### Table of contents

In visual mode, the editor shows a minimap on the right side of the page that reflects the heading structure of your document. Hover over the minimap to expand it into a full table of contents. Click any heading to scroll to that section.

Check warning on line 61 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L61 

Did you really mean 'minimap'?

Check warning on line 61 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L61 

Did you really mean 'minimap'?

### Code block options

Expand All @@ -73,7 +73,7 @@

Open the publish menu and click any changed file to enter diff view. The editor highlights differences between your draft and the last published version. If you're in visual mode, you see a visual diff. If you're in Markdown mode, you see a Markdown diff.

Diff view is read-only. Click the <Icon icon="x" /> button next to the mode toggle to return to editing.

Check warning on line 76 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L76 

Use 'diffs?' instead of 'Diff'.

Check warning on line 76 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L76 

In general, use active voice instead of passive voice ('is read').

## Manage pages

Expand All @@ -90,7 +90,7 @@

Hover over a page and click the gear icon, or right-click and select **Settings**, to configure:

- **Title**, **Slug**, and **Sidebar title**: Control how the page appears in navigation and its URL.

Check warning on line 93 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L93 

Use 'sidebars?' instead of 'Sidebar'.
- **Description** and **Keywords**: Improve search and SEO.
- **Layout**: Choose from standard, wide, centered, or custom.

Expand All @@ -102,10 +102,14 @@

Type <kbd>/image</kbd> to upload a new image or select an existing one from your repository. Type <kbd>/video</kbd> to upload or select a video.

You can also drag and drop files from your computer directly onto a page. In visual mode, the file inserts inline. In Markdown mode, the editor inserts the file path at your cursor position. Images save to your `images/` folder and videos to `videos/`.

Check warning on line 105 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L105 

Use 'Cursor' instead of 'cursor'.

To reuse media that already lives in your project, drag an image or video file from the navigation tree onto the page. The editor embeds the asset inline.

<Note>
Individual media uploads are limited to 50 MB. Compress large images or GIFs, or host larger assets externally and embed them by URL.

Check warning on line 110 in editor/pages.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/pages.mdx#L110 

In general, use active voice instead of passive voice ('are limited').
</Note>

### Light and dark image variants

After inserting an image in visual mode, hover over it to reveal the image toolbar. Use **Light/dark variants** to upload separate images for light and dark mode.
Expand Down
8 changes: 6 additions & 2 deletions es/editor/media.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ keywords: ["editor","media","images","assets"]
## Tipos de archivo admitidos
</div>

* **Imágenes**: PNG, JPG, JPEG, GIF, WebP (máx. 20 MB)
* **Vídeos**: MP4, WebM (máx. 20 MB)
* **Imágenes**: PNG, JPG, JPEG, GIF, WebP (máx. 50 MB)
* **Vídeos**: MP4, WebM (máx. 50 MB)
* **Fuentes**: TrueType (TTF), WOFF, WOFF2
* **Otros**: PDF, ICO (favicons)

Expand All @@ -23,6 +23,10 @@ keywords: ["editor","media","images","assets"]

Arrastra y suelta contenido multimedia desde tu computadora o desde el gestor de recursos sobre una página. En modo visual, la imagen o el video se insertan en línea. En Modo Markdown, el editor inserta la ruta en la posición de tu cursor. Las imágenes se guardan en la raíz de tu carpeta `images/`, y los videos se guardan en la raíz de tu carpeta `videos/`.

<Note>
Cada archivo multimedia tiene un límite de 50 MB. Comprime las imágenes o GIFs grandes, o aloja los recursos más pesados en un servicio externo e insértalos por URL.
</Note>

<div id="slash-command">
### Comando slash
</div>
Expand Down
10 changes: 7 additions & 3 deletions fr/editor/media.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ keywords: ["editor","media","images","assets"]
## Types de fichiers pris en charge
</div>

* **Images** : PNG, JPG, JPEG, GIF, WebP (max 20 Mo)
* **Vidéos** : MP4, WebM (max 20 Mo)
* **Images** : PNG, JPG, JPEG, GIF, WebP (max 50 Mo)
* **Vidéos** : MP4, WebM (max 50 Mo)
* **Polices** : TrueType (TTF), WOFF, WOFF2
* **Autres** : PDF, ICO (favicons)

Expand All @@ -21,7 +21,11 @@ keywords: ["editor","media","images","assets"]
### Glisser-déposer
</div>

Glissez-déposez des éléments multimédias depuis votre ordinateur ou le gestionnaire de ressources dans une page. En mode visuel, l&#39;image ou la vidéo est insérée directement dans le contenu. En mode Markdown, l&#39;éditeur insère le chemin à l&#39;emplacement de votre curseur. Les images sont enregistrées à la racine de votre dossier `images/`, et les vidéos à la racine de votre dossier `videos/`.
Glissez-déposez des éléments multimédias depuis votre ordinateur ou le gestionnaire de ressources dans une page. En mode visuel, l'image ou la vidéo est insérée directement dans le contenu. En mode Markdown, l'éditeur insère le chemin à l'emplacement de votre curseur. Les images sont enregistrées à la racine de votre dossier `images/`, et les vidéos à la racine de votre dossier `videos/`.

<Note>
Chaque fichier multimédia est limité à 50 Mo. Compressez les images ou GIF volumineux, ou hébergez les ressources plus lourdes en externe et intégrez-les par URL.
</Note>

<div id="slash-command">
### Commande /
Expand Down
Loading