You have photos of great work. They sit in a gallery with names like IMG_4417. A homeowner scrolls past them in four seconds and learns nothing.
Here is how to write a project description for a contractor website that a homeowner reads to the end. One job. One page. Finished this week.
Why does one well-written job page beat a gallery of unlabeled photos?
A photo shows a result. It does not show judgment.
A homeowner deciding between you and two other bids cannot tell from a pretty picture whether you scraped, primed, repaired, or just rolled paint over a problem. A job page tells them. It shows how you think, which is what they are really hiring.
It also gives search engines something to read. A gallery is mostly silence to Google. A page with real words about a real job in a real town is a page it can place.
We built finished-job pages for A New Leaf Painting in Jacksonville, and we use their structure below. Each page covers what the crew found, the prep and repairs, the products and colors, the result in photos, and the HOA approval details neighbors ask about. Seven steps follow. You can do all of them in an afternoon or two.
Step 1: Pick a job you are proud of and have photos for
Do not start with your biggest job. Start with the one you can document best.
You need three things:
- Before photos, even rough ones
- A few finished photos in decent light
- A job you remember well enough to talk about
If you have to guess what happened, pick a different job. A recent one is usually easiest. Ask your crew lead, who remembers more than the invoice does.
Step 2: Write down what the crew found when they arrived
This is the section most contractors skip, and it is the most useful one.
Describe the condition of the place in plain words. Peeling on the south side. Soft wood under the window trim. Old caulk pulled away from the siding. Whatever was true.
Keep it short. Three to six sentences is plenty.
Why it works: a homeowner reading this recognizes their own house. They think, "That is my porch." That is the moment a stranger becomes a lead.
Step 3: Describe the prep and repairs in plain words
Prep is where honest contractors separate themselves from the rest, and it is invisible in the finished photos. So say it.
Write what was done, in order:
- What was cleaned, scraped, sanded or washed
- What was repaired or replaced
- What was sealed, caulked or primed
Skip the jargon. If a customer would need to look a word up, use a simpler one. And do not pad it. A short list of true steps beats a paragraph of promises.
This section answers the question behind every estimate: "Why does your price look different from the other guy's?"
Step 4: List the products and colors used
Name them. Brand, product line, color name and number, finish.
Homeowners screenshot this. They carry it to the paint store. They send it to a spouse with "this one?" in the text. A page with exact colors gets saved, and a saved page gets a call.
A simple list works:
- Body color
- Trim color
- Door or accent color
- Primer or specialty products
Only list what was actually used on this job. If you are not sure of a color code, check the work order before you publish. A wrong number is a small error that costs you trust.
Step 5: Show the result in photos with honest captions
Now the photos. Lead with the best finished shot, then add a few that tell the story: a detail, a repaired spot, a side that people do not usually see.
Caption each one with something true. "Front entry, finished" is fine. "Repaired trim at the garage, primed and painted" is better.
Two rules:
- Put before and after side by side only if both are from this job
- Never use a photo from another job to fill a gap
Five good photos beat twenty mediocre ones. Resize them so the page loads quickly on a phone, because plenty of your readers will open it on one. If you want to see how yours does, our speed test will tell you.
Step 6: Add the HOA or neighborhood details people ask about
In the Triangle, plenty of your customers live under an HOA. Their first question is rarely about paint. It is, "Will the board approve it?"
If the job needed approval, say so. Note what the association asked for, whether colors came from an approved palette, and how the approval went. Keep it factual and keep private details out. No names of neighbors, no addresses.
This is the section that makes neighbors in the same community feel they have found someone who already knows the process. It is a detail most contractor sites leave out, so including it sets you apart.
If the job had no HOA, skip this section. Do not invent one.
Step 7: Name the town and put the job on your map
Tell the reader where the job was. The town, and the neighborhood if the customer is fine with it. Raleigh, Cary, Apex, Durham, wherever the truck actually went.
This matters for a reason beyond search. A homeowner in your service area wants to know you have worked near them. A page that says so is proof.
At A New Leaf, about five hundred past jobs are plotted on a map of Northeast Florida, so a homeowner can see whether the crew has painted near them before they call. You do not need five hundred. You need the first one, then a habit.
One firm rule. Never caption a job from another town as local. If you want a Cary page to look busy, do not put a Raleigh job on it. On the A New Leaf site, every town page has its own finished jobs and its own map, and never another town's name or a neighbor's job captioned as local. Each page says something true about the place. Do the same.
Mistakes that make a job page worthless
A few problems turn a job page into dead weight:
- No words. Photos with no description are a gallery, not a page.
- Vague claims. "Quality work and great service" tells nobody anything. Specifics do.
- Borrowed jobs. Photos or towns that do not belong to the job. This is the one that gets you caught.
- Hiding the problems. Rot, damage and repairs are the interesting part. Show them.
- Waiting for perfect. A good page published beats a perfect page in your drafts folder.
- Writing it once. One page is a start. A job page after every strong finish is a habit that adds up.
Your move this week
Pick one finished job today. Pull the photos, then ask your crew lead for ten minutes and write down what they found when they arrived. That alone is the hardest part.
Fill in the other six steps over the next few days and publish the page.
If your site makes that hard, with no place to put a job page or no way to tie jobs to towns, that is a site problem, not a writing problem. Our notes on contractor website design explain what to look for.