Upload images and update page media
Find your media library, use the right image field and add useful alternative text.
Beginner guide · Published on 5 September, 2026
Try it on your website
Choose a website to upload and manage its images.
Opens in a new tab. Sign in if needed, then choose your website.
Upload and find images in the media library
Upload and place an image
Prepare the image
Choose an image you have permission to use. Give the file a descriptive name such as
team-at-work.jpg. Match its shape to its purpose: a wide image for a banner and a square image for a square card. Avoid putting essential copy only inside an image.Upload or reuse an existing file
Open Appearance → Media Library. Search first to see whether the image is already present. To add a new file, use Upload or drag it into the upload area. Wait for the file to appear in the library.
Update an image inside a page
Return to the page's Page Builder. Expand the component that displays the picture and open its image field. Use that field's available media controls to choose or replace the image. The exact field name depends on the section. Uploading to the library alone does not place an image on a page.
Distinguish the featured image
Page Details → Featured Image is a separate setting, often used for page cards or sharing previews depending on your template. Replacing it does not necessarily replace the hero image. Check both the page body and featured image if you are updating a campaign.
Write alt text and inspect the result
Add a concise description that communicates the image's purpose, such as Our support team helping a customer. Use the page's Alt Text control for its featured image. Preview the page and check cropping, clarity and whether important faces or text are cut off.
Featured image and alt text live in Page Details
Check your progress
The intended image appears in the correct place, its crop works and its alternative text is meaningful.
If you get stuck
Uploaded but not visible? Select the image in the page component. Changed the featured image but the banner stayed the same? Open the banner's image field in Page Builder. Looks stretched? Choose an image with a closer aspect ratio and check the component design.
Try this with AI
Replace the example website and page with your own before sending.
On [my website], find a suitable existing image for [section] on [page URL]. Show me your choice and suggested alt text before replacing it. Keep the page unpublished until I review the preview.