Images
Avoid unnecessary decoration. Only use images if there is a real user need.
All images should be 960 pixels wide by 640 pixels high at 72 dpi.
You can resize images using free software like GIMP or an online photo editor like PIXLR.
Aspect Ratio
The aspect ratio for photographs should be 3:2.
Typically a 3:2 aspect ratio is 960×640 pixels, but scales accordingly for each breakpoint.
Photography
Scaling
Scale the browser’s window to see the different breakpoints and image scalings.
Screen size | Image Size |
---|---|
XXL (1440+) | 960 x 640 |
XL (1200-1439px) | 840 x 560 |
L (992-1199px) | 660 x 440 |
M (768-991px) | 570 x 380 |
S (577-767px) | auto |
XS (0-576px) | auto |
Using our developers assets, the images scaling adjusts automatically.
Example
Illustrations or representative imagery
If your image represents something physical, such as a letter, document or credit card you should use the aspect ratio of that item. You can do that by adding the class govcy-img-ar-auto"
on your image.
Example
Do you have a document printed in your name?
![Example of physical representation of a document](/govcy-design-system-docs/img/v3_physical_imagery.jpg)
HTML code
<h3>Do you have a document printed in your name?</h3>
<img src="/govcy-design-system-docs/img/v3_physical_imagery.jpg" alt="Example of physical representation of a document" class="govcy-img-ar-auto">
Captions
The caption field is optional. You can use a caption to:
- label a graph, infographic or diagram
- name a person in a photo
- attribute an image
If you add a caption, you should also add alt text. A caption with no alt text is poor for screen reader users because:
- some assistive technology does not read captions if the alt text field is empty, which means users miss the information
- some assistive technology always reads captions, but if the alt text field is empty the user may not be aware that the caption relates to an image
Do not use the caption field to describe the image or duplicate content in the body text.
If you do not need a caption, do not use one.
Alt Text
Alternative text, or alt text, is read out by screen readers or displayed if an image does not load or if images have been switched off.
All images, except decorative images, must have alt text that:
- tells people what information the image provides
- describes the content and function of the image
- is specific, meaningful and concise
Use normal punctuation, like commas and full stops, so the text is easy to read and understand.
Do not:
- include the name of the photographer or person who created the image
- start with ‘Image of’, ‘Graphic of’ or ‘Photo of’
- repeat information from the page
- include extra information not in the image
Example
HTML code
<img src="/assets/images/max-the-dog.jpg" alt="Max the brown dog, sitting at a natures trail road, looking patiently at his owner.">
Some images do not need descriptions. Use alt=""
if the image is:
- decorative and does not include important content
- an icon that has a text label that the alt text would repeat
- used in a link and the image is not needed to understand the link
Use the Web Accessibility initiative alt decision tree to work out if the image needs alt text.
Images that contain text
Avoid images that contain text, especially PNGs and JPGs because the text becomes unreadable when the user zooms in. If the image does contain text, use SVG because it remains readable when the user zooms in. The alt text should be the same as the text displayed in the image.
Accessibility
Make sure you follow the instructions:
- on use of alt
- on use of images that contain text