An independent reference about texts for small websites. Not a website builder, hosting provider or web studio, and takes no orders; not connected with the former site on this domain.

Troubleshooting

Troubleshooting

If nobody calls or writes through your website, the problem is often not the design but the words. Below are common problems with the texts of small websites and calm ways to fix them without starting from scratch.

A question you are asked on the phone again and again is a line missing from your website.

— Editor's note

How this section works: the advice is given in general terms and suits any website where you can edit the text yourself.

If something goes wrong

Nobody reads the texts to the end

Move the essentials to the top: the first paragraph should answer the visitor's question, not tell the backstory. Break up long paragraphs, add subheadings people can skim, and remove openings like "Welcome to our website".

It is not clear where to click

Buttons and links should say what will happen: "View the timetable", not "Learn more". If a page has several identical "Read more" links, rename each one according to its meaning. Make one main action, and make it stand out.

The website has out-of-date information

Add an "up to date as of" date to timetables, prices and rules, and set yourself a reminder to check them. If the information is no longer correct and there is nothing new yet, say so honestly and point to where people can find out more.

There is a mistake in the contact details

Call and write using every contact method listed yourself. Check that the number can be dialled from a phone with a single tap, that the email address has no typos and that the reply hours match reality.

Visitors keep asking the same questions

Note down recurring questions for a couple of weeks and answer them right on the website, in the text of the relevant page or in the FAQ section. Phrase the answer the way people ask, not the way official documents put it.

The text sounds like an official notice

Replace nouns made from verbs with the verbs themselves: not "the acceptance of applications is carried out" but "we accept applications". Break up long chains of "of" phrases and address the reader directly as "you".

If a visitor complains that a text is unclear

  1. Say thank you

    The person took the time to tell you about the problem. Reply calmly and without making excuses: messages like this help make the website better.

  2. Ask what they were looking for

    Ask which page they were on and what they wanted to find. Often the information is there but hidden under an unexpected heading.

  3. Answer the question straight away

    Do not make them wait for the website to be fixed: answer them personally first, then work on the text.

  4. Fix the page

    Rename the section, add a line or rearrange the paragraphs so that the next visitor finds the answer on their own.

  5. Check similar places

    If the confusion arose on one page, it is probably on neighbouring pages too. Go through them with the same question in mind.

  • Guides

    Step-by-step guides: the About page, the home page, contacts, the contact form and photo captions.

  • Tools

    What a writer can use without special software: spell checking, reading aloud, a paper draft, a checklist and a link check.

  • Safety

    What not to publish on a website: unnecessary personal data, photos of children without consent, internal documents and other people's materials.

  • Glossary

    Glossary: heading, lead, navigation, officialese, alt text, personal data, licence and other terms.

  • FAQ

    Answers to common questions about the reference, about texts and page structure, about visitor data and rights to materials.

Sources

  • Editorial materials of the reference

These materials are written in general terms as of the preparation date and are not a substitute for legal advice. Laws and guidelines change over time, so for questions about personal data and copyright, check the current text of the law.