A property project gallery works best when each group of images explains one project, your role in it and the stage shown. Organise the collection around questions a buyer would ask, then use captions to add context. A long wall of attractive photographs gives much less help if nobody can tell what you actually did.
Start with the project record
Before choosing a layout, make a short record for each project: project type, broad location, relevant date, your role, work shown and publication permissions. Keep internal details separate from the information approved for public use.
The role is particularly important in property. A photograph might show work by an architect, developer, contractor, interior designer and several specialist suppliers. Your caption should explain your contribution without implying ownership of everybody else’s work.
If the project is confidential, decide whether there is enough approved context to publish it usefully. Removing the customer’s name does not necessarily make a photograph anonymous. Check visible documents, addresses, people and recognisable private details before uploading.
Group by a decision people need to make
Useful groups might distinguish residential and commercial work, new development and refurbishment, or particular project types. Choose categories that match the work you want to show and have enough examples to support.
Do not create a filter for every material, room and postcode. Too many choices can make a small portfolio look fragmented. Start with a handful of meaningful groups, then check whether visitors can find relevant examples without understanding your internal filing system.
Use the same category names in project cards, headings and navigation. A visitor who chooses refurbishment should not arrive in a section labelled transformation unless the relationship is obvious.
Give each project a readable sequence
Choose an opening image that shows the overall result or setting. Follow it with views that explain the work, then a few details that matter to the story. A sequence is more informative than placing every photograph in upload order.
Keep before, during and completed images clearly labelled. If a render appears alongside photography, identify it as a visualisation. Do not let an image of a proposed scheme look like a completed project.
For a hypothetical office refurbishment, the sequence could show the original space, the revised layout and a detail of the finished meeting area. The captions would explain the purpose of the changes and the contributor’s actual role, without inventing performance claims.
What should captions add?
A caption should answer a question the image alone cannot. Name the project stage, relevant feature or reason for including the view. Avoid repeating visible colours or adding praise that tells the reader nothing.
- Explain the specific work shown.
- Distinguish your contribution from other contributors’ work.
- Identify a render, sample, staged room or earlier project phase.
- Use a broad location only where it is approved and useful.
- Credit photography or other contributors where agreed.
Keep captions short enough to read beside the image. Put the fuller brief, process and evidence in the project page. Our guide to using completed projects in marketing covers how those materials can work together.
Make the images understandable beyond sight
The W3C guidance on groups of images explains that related images may need individual text alternatives which also make their relationship clear. Apply that to the meaning of the gallery, rather than copying the same project name into every image description.
Write alternative text for information the image contributes. Use the visible caption for context everyone should read. Do not fill either with search phrases or a catalogue of every object in the frame.
Check the gallery with a keyboard. People should be able to open and close an enlarged image, identify the controls and return to the place they started. If a slider hides useful photographs behind unclear controls, a simpler layout may serve the work better. The image alt text guide covers the wording in more detail.
Keep the page quick enough to browse
Use appropriately sized image files and let the developer serve suitable sizes for different screens. Keep originals in the project archive rather than uploading enormous source files as the only public version.
Check portrait and landscape crops on a phone. A crop that removes the feature described in the caption makes the page confusing. Do not choose a uniform shape at the expense of showing the work properly.
Test a gallery containing your larger projects, not only the smallest sample. The layout should remain usable as the collection grows and as older work moves down the page.
Give relevant work a useful next step
Link each project to the service or industry context that explains what you can discuss. Keep the enquiry route close enough to find without covering the images.
Review the gallery periodically for outdated permissions, broken project links and examples that no longer represent the work offered. Our construction and built environment page provides related context, and the industry overview helps visitors find the appropriate starting point.