Build a portfolio with image galleries

Guides

Select the work before arranging it

Create a portfolio page that helps visitors understand your work without making them download every original image. Choose a small, coherent selection and group it by project or subject. Keep a contact action near the end so interested visitors know how to reach you.

You need administrator access, publication rights for the images, and approved descriptions. Remove private client details and obtain any required permission to identify people or locations. Keep original files in your own archive; a website gallery is not a backup system.

For a first portfolio, choose six photographs from one completed project. Prepare a short introduction explaining your role and descriptive text for each image. Do not invent client endorsements or claim work completed by someone else.

Build a native gallery page

1. Open the intended website's Pages and use Add Page, or edit an existing portfolio page. Set its title and URL in Page Settings. Retain the real header and write an introduction that provides context for the images.
2. In a body section, use Add Block and select Gallery. The gallery editor offers Upload and Browse Existing. Upload only the selected images, or choose images already associated with the website. Wait for successful uploads before treating the gallery as complete.
3. Arrange the images in a deliberate sequence. The gallery editor supports dragging images to reorder them. Start with an image that explains the project, then add details and alternate views. Avoid near-duplicates that make the page longer without adding information.
4. Edit image titles and descriptions through their thumbnails. Describe the subject or relevant detail instead of repeating a filename. Inspect the rendered alternative text as well as any visible caption; text that helps a screen-reader user is not necessarily the same as a promotional project title.
5. Review the gallery's columns, ratio, spacing, and lightbox setting. A consistent ratio can make the grid easier to scan, but check whether it crops essential details. Lightbox viewing should preserve access to the complete image. Test the chosen presentation rather than assuming all image shapes suit one setting.
6. Add another section only when the next group needs its own explanation. Use a Buttons block for an approved contact destination. Save the page explicitly after completing the gallery and surrounding copy.

Inspect the visitor experience

Open the saved page outside the editor on a phone and a desktop. Check the first screen, image loading, crops, reading order, descriptions, and contact link. If lightbox is enabled, open several images and test navigation and closing with the keyboard. Ensure focus remains usable.

A broken image may indicate an incomplete upload or a removed media asset. Inspect the source reference before uploading another copy. Removing an image from a gallery and deleting it from the media library are different actions; do not delete shared media without checking other pages.

See media and integrations, page anatomy, and design and styling for the underlying controls.