Work with images, videos, and files

Adding media to your pages enhances the visual appeal and improves how you convey information. You can use images to illustrate a point, videos to provide detailed instructions, GIFs to add some fun, or files to share important documents.

Confluence supports various media formats, including:

• Images: JPEG, PNG, GIF, BMP

• Videos: MP4, MOV, AVI

• Audio: MP3, WAV

• Files: PDFs, Microsoft Office documents, text files, and more.

In this guide, you can learn how to use media elements to create dynamic content that captures your audience’s attention and communicates your message more effectively.

Add media to your page

Follow these steps to add images, videos, GIFs, and files to your content:

Using the toolbar or / command

1. Select the Add image, video, or file on the toolbar or type /image on the page and select Image, video, or file.

2. Select the media file from your computer.

Dragging and dropping files

1. Open the page where you want to add the media.

2. Drag the desired file from your computer and drop it onto the page.

3. The file will be uploaded and added to your page.

Following these steps, you can integrate images, videos, GIFs, and files into your Confluence pages, making your content more engaging and appealing.

Formatting and customizing media

Resizing and aligning images and videos

Resizing and aligning images and videos can improve your pages' visual appeal and readability. Here's how you can manage these aspects:

Using drag handles to resize

1. Select the image or video you want to resize.

2. Drag the handles on the sides of the media to adjust its size. The media will proportionally grow or shrink based on how much you drag the mouse.

Resizing to specific pixel values

1. Select the image or video you want to resize.

2. In the toolbar, enter the desired width or height in pixels. Note that only one dimension (width or height) can change at a time; the other dimension will adjust proportionally.

Converting to pixel-based resizing

1. Select the media item that needs conversion (it will have a yellow dot in the top-right corner).

2. Either drag the handle to resize the item or select the Convert to pixels in the toolbar to switch to pixel-based sizing.

By resizing and aligning your images and videos, you can enhance your pages' visual impact and readability, ensuring your content is well-organized and appealing.

Customizing image and video settings

Customizing image and video settings can help you enhance the visual presentation and accessibility of your media. Here's how you can adjust various settings:

Adding captions

1. Select the image or video you want to caption.

2. In the floating toolbar, select the Add caption option.

3. Enter your caption text. You can’t change the text size and alignment but can apply other formatting.

Adjusting border options

1. Select the image or video.

2. In the floating toolbar, select the Border options.

3. Select your desired border color and size.

Setting image alignment

1. Select the image or video.

2. In the floating toolbar, select the Image alignment.

3. Select how you want the image or video aligned on the page and how the text should flow around it.

Displaying images inline or as block elements

1. Select the image you want to display inline or as a block element.

2. In the floating toolbar, select the Inline or Original size option.

Adding links to images

1. Select the image.

2. In the floating toolbar, select the Link option.

3. Add a link to a page or an external URL.

Previewing images

1. Select the image.

2. In the floating toolbar, select the Preview option to view the full-size image while editing.

Editing alt text for accessibility

1. Select the image or video.

2. In the floating toolbar, select the Edit alt text option.

3. Supplemental text should accompany the media, providing context and meaning to all users. Alt text is especially effective in assisting people who rely on screen readers.

Managing file settings

Managing file settings lets you control how files display and interact on your pages. Here’s how you can manage your file settings:

Displaying files as inline tiles or thumbnails

You can select to display files as either inline tiles or thumbnails to enhance the visual presentation and accessibility of your content.

• Inline tiles:

  • Select the file you want to display.

  • In the floating toolbar, select the Change view option.

  • Select Inline to display the file as an inline tile.

• Thumbnails:

  • Select the file you want to display.

  • In the floating toolbar, select the Change view option.

  • Select Thumbnail to display the file as a thumbnail.

Previewing files

• Select the file you want to preview.

• In the floating toolbar, select the Preview option.

• The file will open in viewer mode, allowing you to see its contents without downloading.

Downloading files

• Select the file you want to download.

• In the floating toolbar, select the Download option.

• The file will download to your computer or device.

Collaborating on media

Collaborating on media in Confluence allows teams to interact, comment, and share insights on images and videos. Here's how you can collaborate using media:

Adding and viewing comments

Adding comments to images and videos can facilitate discussions and feedback.

• Adding comments:

  • Select the image or video you want to comment on.

  • In the floating toolbar, select the Add/view comment option.

  • Type your comment in the provided field and submit it.

• Viewing comments:

  • Select the image or video with existing comments.

  • In the floating toolbar, select the Add/view comment option to see all comments associated with the media.

Embedding social videos and images

Using the Widget connector macro, you can embed live content from various social media platforms to enrich your Confluence pages.

• Embedding YouTube, Vimeo, and Flickr content:

  • Copy the URL of the content you want to embed.

  • Paste the URL onto your Confluence page.

  • The link will automatically convert into a playable video or viewable image.

• Exploring additional macros:

  • Browse through the complete list of macros to find other valuable features for embedding content from different platforms.

Collaborating on media can enhance team communication, gather valuable feedback, and create more dynamic and interactive Confluence pages.