Images
Images support written content, strengthen brand identity and provide visual context. They help break up text-heavy layouts and can be used to highlight key information or create visual impact.
When to use
Use images in your emails when they:
- Add value or context to the content rather than being decorative.
- Support key messages, such as showcasing a service, product, or event.
- Strengthen brand identity with approved photography or visual assets.
- Improve the scannability of long content by breaking it into sections.
Design guidance
- Use high-quality, optimised images that won’t slow down load times.
- Keep file sizes as small as possible (under 200Â KB is recommended).
- Test on mobile to ensure images resize appropriately and remain legible.
- Maintain consistent aspect ratios when displaying images side by side.
Accessibility
- Provide meaningful alternative text (alt text) that explains the image’s purpose.
- Avoid embedding text in images, as it cannot be read by assistive technologies.
- Ensure images meet minimum colour contrast and readability standards.
- Use decorative images sparingly and give them an empty alt attribute (alt="").
- Design images to support accessibility for all users, including people who use screen readers, screen magnifiers or other assistive technologies.
Variations
The Images component offers flexible layout options to support a range of content. From full-width banners to side-by-side layouts, these options ensure images adapt to both single-column and multi-column designs.
Full width
Displays one image spanning the entire content area. Use this layout for banners, section dividers or strong visual moments.
One column
Shows a single image within one grid column. This layout pairs well with text blocks or when the image supports specific content.
Two column
Places two images side by side in equal-width columns. Ideal for comparisons, showcasing multiple features or telling a visual story.
Alignment
Use alignment settings to control how images sit within a multi-column layout. For example, align images to the left or right of accompanying text to create visual rhythm and balance.
| Prop | Type | Default | Description |
|---|---|---|---|
src | string | — | The image source URL. Must be an absolute or relative path to the image file. |
alt | string | — | Alternative text for accessibility. Describe meaningful images; use an empty alt attribute for decorative images. |
width | number | string | 100% | Specifies the image width in pixels or percentage. Defaults to full container width unless overridden. |
height | number | string | auto | Specifies the image height in pixels or percentage. When omitted, height scales proportionally to width. |
aspectRatio | string | — | Optional fixed aspect ratio (e.g., "16:9", "4:3", "1:1"). Helps maintain consistent sizing across layouts. |
alignment | string | center | Controls horizontal alignment. Options: "left", "center", "right". Useful for multi-column or asymmetrical layouts. |
columns | number | — | Defines how many columns the image spans when placed in a grid. Common values: 1, 2. |
mobileClass | string | mobile-full-width | Responsive utility applied at ≤639px. Ensures images stack and remain legible on smaller screens. |
bgcolor | string | transparent | Optional background colour behind the image. Must use NSW digital palette tokens for consistency. |