You keep all your photos, videos and files centrally in the media library. Photos are uploaded (or dragged straight into the conversation with the assistant); videos are added via a URL (for example a Vimeo or YouTube link). Below are the options, each with the prompt underneath.
1. A single image
Upload this photo (dragged into the conversation) and place it at the top of the page.2. A clickable photo gallery (with zoom and thumbnails)
1/4
Upload these four photos and turn them into a clickable photo gallery.3. A gallery that advances automatically (with crossfade)
1/4
Upload these photos and create a gallery that advances automatically with a soft transition.4. A video with controls
Put the video from this URL (https://vimeo.com/241817078) on the page, with playback controls.5. A background video that autoplays and loops
Set the video from this URL (https://vimeo.com/241817078) as a background at the top of the page, autoplaying and muted.Why good media speeds up trust
Visitors decide within seconds whether a page feels credible, and real photos usually do more work than another paragraph of text. A gallery of actual product or project photos on a page often keeps people scrolling longer than plain copy alone.
A common use case: a portfolio or venue page where a swipeable gallery lets visitors browse photos themselves instead of relying on one hero image — see the swiper block for a touch-friendly variant of the gallery shown above.
If you show many items with their own photo — products, team members, listings — combine media with dynamic pages so every item gets its own page with its own image, generated automatically.
Practical tip: compress photos before uploading. Large, unoptimised images are one of the most common reasons a page feels slow, even when everything else is fast.
Choosing between a gallery and a single hero image
A single strong image often communicates more than a gallery of mediocre ones — if you only have one genuinely good photo, use it as a hero rather than padding a gallery with weaker shots just to have more content. A gallery earns its place when there are genuinely several angles or moments worth seeing: a venue, a product from multiple sides, a project's before-and-after.
Autoplay is worth using sparingly. A gallery that advances on its own works well for atmosphere — a restaurant's dishes, a venue's ambience — but can frustrate visitors trying to read captions or study a specific photo before it moves. If the content needs close attention, let visitors control the pace themselves.
Media across different kinds of sites
A hospitality business leans heavily on photography — rooms, food, the building itself — because the buying decision is largely visual. A B2B service business usually needs far less photography and more diagrams, screenshots or short explainer video. A creative portfolio is almost entirely media: the images and video are the content, and everything else on the page exists to support them.
Video works differently from photos in each case too. A background video works well behind a hero section on a hospitality site to set a mood, while the same autoplay behaviour on a text-heavy service page would mostly distract from the message.
Common mistakes with images and video
The most common mistake, beyond skipping compression, is missing alt text. Every image should describe what it shows in a short sentence — this matters for visitors using a screen reader, and it also gives search engines something to index beyond the surrounding text, which directly supports your SEO.
The second is inconsistent aspect ratios within a single gallery, which makes a page feel unpolished even when the individual photos are good. Crop to one consistent ratio before uploading, rather than relying on the gallery layout to smooth over mismatched dimensions.
For background on how images and video fit into the underlying page structure, see content is JSX in the knowledge base.