A NSW Government website

Command Palette

Search for a command to run...

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.

PropTypeDefaultDescription
srcstring—The image source URL. Must be an absolute or relative path to the image file.
altstring—Alternative text for accessibility. Describe meaningful images; use an empty alt attribute for decorative images.
widthnumber | string100%Specifies the image width in pixels or percentage. Defaults to full container width unless overridden.
heightnumber | stringautoSpecifies the image height in pixels or percentage. When omitted, height scales proportionally to width.
aspectRatiostring—Optional fixed aspect ratio (e.g., "16:9", "4:3", "1:1"). Helps maintain consistent sizing across layouts.
alignmentstringcenterControls horizontal alignment. Options: "left", "center", "right". Useful for multi-column or asymmetrical layouts.
columnsnumber—Defines how many columns the image spans when placed in a grid. Common values: 1, 2.
mobileClassstringmobile-full-widthResponsive utility applied at ≤639px. Ensures images stack and remain legible on smaller screens.
bgcolorstringtransparentOptional background colour behind the image. Must use NSW digital palette tokens for consistency.
Previous
Divider
Next
Link