If you are using an image that contains text, it is best to use the image widget.
The image widget scales with the screen size. This helps keep the content of the image clearly visible across different devices.
When should you use the image widget?
Use the image widget if:
the image contains text
it is important that the full image remains visible
you want the image to scale properly on desktop and mobile
This is usually the safest choice for banners or visuals with text. You can also optionally set a separate image for mobile view.
When should you be careful with the header widget?
With the header widget, the image may be cropped on mobile. This means part of the text may no longer be visible.
Please note: are you still using the header widget for an image with text? Always take the safe area mobile into account. This helps prevent important text or visual elements from being cut off in mobile view.
Our advice
Does your image contain text? Then, by default, use the image widget.
Only use the header widget if your design still works well when parts of the image may be cut off on mobile.