Images, files and embeds
Adding pictures, attachments, and third-party media to a page, along with the upload limits that apply.
4 min readUpdated
Adding Media#
Image and File are available in the slash menu, while Image, Embed, Video, and Audio are available in the Insert (+) menu. The media buttons in the toolbar are split: select the button to open your file picker, or select the caret to open an insert-by-URL dialog.
Inserting an empty media block leaves a placeholder, such as "Add an image", "Add a file", "Add a video", or "Add an audio file", which you can select at any time to add content. You can also drag files directly from your computer onto the page.
Upload Limits#
Every upload is limited to 100 MB per file, and only the following file types are accepted:
- Documents: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
- Text: TXT, CSV, Markdown
- Images: PNG, JPEG, WEBP, GIF, SVG
- Media: MP4 video, MPEG audio, WAV audio
- Archives: ZIP
| What You See | What It Means |
|---|---|
| Max file size is 100 MB | The file is too large. Compress it or link to it instead. |
| File type not supported | The file type isn't included in the supported list above. |
| "{name}" is over the 100 MB limit | One file in a multi-file selection is too large. The other files still upload. |
| "{name}" isn't a supported file type | The file type isn't supported, while other selected files can still upload. |
Working with an Image#
- Drag the handles on the edges to resize the image.
- Choose Caption and type below the image. The placeholder reads "Write a caption…".
- The image toolbar also includes an Edit link and a delete button.
Embeds#
Choose Insert → Embed to add media using a link. Paste the link into the "Paste the embed link…" field.
YouTube, Vimeo, Dailymotion, Youku, Coub, and posts from X render inline. Other links remain as plain links.