Add images and videos
Add screenshots, diagrams and videos to a topic, then size, place and caption them.
This page covers Rich Text topics. On a Page, images and videos go inside components. See Build a page with components.
Add an image
Use whichever way is quickest:
- Paste: copy a screenshot or image and paste it into the topic with
Ctrl+V(Cmd+Von Mac). - Drag: drag image files from your computer into the topic.
- Upload: select the arrow next to Insert image in the toolbar, then Upload from computer. You can pick several files at once.
- From a link: select the arrow next to Insert image, then Insert via URL, and paste the image's address.
Supported formats are PNG, JPG, GIF, SVG and WebP. Sonat stores uploaded images with the document and serves them in a web-friendly size.

Place and size an image
Click the image. A small toolbar appears above it:
- In line: the image sits inside a line of text, like a large character. Good for icons.
- Centered image: the image sits on its own line in the middle.
- Left aligned image and Right aligned image: text wraps around the image.
- Resize image: pick Original, 25%, 50% or 75%. You can also drag the handles on the image's corners.

Add a caption and alt text
- Click the image.
- Select Toggle caption on and type the caption under the image.
- Select Change image text alternative, describe what the image shows, and confirm.
Make an image a link
Click the image, select Link in the main toolbar, and paste the address. Readers who click the image go to that address.
Manage a document's images
Each document has an image library. Open the document and select Images in the left menu to see every image uploaded to it.
- Upload images from your computer, or import them from Dropbox, Google Drive, OneDrive, Unsplash or a link. Each image can be up to 2 MB.
- Delete images you no longer need.
- Pick images from this library when you fill in an image field in a component.

Add a video
Sonat embeds videos from video services. You can't upload a video file.
- Upload the video to YouTube or Vimeo and copy its page address.
- In the topic, select Insert media in the toolbar.
- Paste the address into Media URL and confirm.
The video plays on the published page. Dailymotion and Spotify links work the same way. For other services, paste their embed code with Insert HTML. See Tables, code and embeds.
If something goes wrong
An image won't upload
Check the format. Only PNG, JPG, GIF, SVG and WebP are accepted. On the Images page, files over 2 MB are refused, so shrink the image and try again.
The video shows as a link, not a player
Paste the address of the video page itself, for example youtube.com/watch?v=…, not a playlist, channel or search page.