How to overlay text onto an image in Confluence Cloud | Formatting 101
Share on socials
How to overlay text onto an image in Confluence Cloud | Formatting 101

Jump to Section
Jump to section
How to overlay text onto an image
Use cases for text overlays
Here’s how to overlay a snippet of text onto an image in Confluence Cloud - no design tools needed.
Have you recently migrated to Confluence Cloud and are looking for ways to overlay text onto your images? We’re here to show you how in just a few steps. The best part? You don’t need to know CSS or HTML!
Thanks to Mosaic: Content Formatting Macros & Templates, you can create text overlays that provide instant context, improve the visual hierarchy of your page, and clear the clutter of additional text.

How to overlay text onto an image
⏰ Setup time: 2 minutes or less
○ App: Mosaic for Cloud
○ Difficulty: Easy
To overlay text onto an image, we’ll be using the Background macro that comes with Mosaic. Get your 30-day free trial today:
- In edit mode on your Confluence page, type /background. Select the Background macro from the dropdown.
- Add an image. To do this, navigate to the Add image section and:
- Select an image from the Pexels library, or
- Upload a custom image from your computer.
- (Optional) Change the background colour (this is the colour overlay) and customise the opacity of the image (how visible the image will be).
- (Optional) Choose a text colour.
- Select Save to close the editor.
- Type or paste the text you wish to overlay in the body of the macro.
- Click Save or Update to see your results!
Quick stats | Creating the same effect in Confluence Server/Data Center requires:
⏰ Setup time: 4 minutes or more
○ Macros needed: DIV, and CSS Style Sheet macro
○ Pre-requisites: Familiarity with HTML, and CSS
How can I use text overlays in my content?
Text overlays are great for a number of uses. Here are just a few:
- Hero sections: Create a strong first impression with a message and visual context
- Internal announcements: Share news, or events in a visually engaging way
- Testimonials: Pair client imagery with a key quote or statistic
- Section headings: Visually divide your page with relevant imagery
- Blog posts: Add a professional banner to your articles
Key takeaways
- Text overlays provide extra context and visual cues, and optimise the space on a page.
- Creating text overlays in Confluence Cloud is much quicker and easier than in Server or Data Center.
- With the Background macro, included in Mosaic, you can format text and imagery quickly, and without any design or coding experience.
Related Content
Read moreWritten by
Related Content
Read more




