Fix what Pre-Flight finds
What each Pre-Flight finding offers: spelling with the words around it, drafted fixes to copy, a page to send visitors to from a broken link, alt text drafted from real context and better colours for text that is hard to read.
Every Pre-Flight finding says what is wrong and which page it is on. Wherever we can tell what it should be, it also offers a fix you can copy and paste. This guide goes through what each kind of finding gives you. For running the checks and reading the results, see The Pre-Flight check.
Spelling and grammar
The read-through reads the words on the pages you choose under What should Pre-Flight check? at the top of the Pre-Flight tab. Choose English (UK) or English (US) under Spelling standard when you open the check, then run it. It is marked Beta, so its findings say Check this: look at the page before you change anything.
- A mistake the read-through is sure of says what it is, such as a typo or a missing word, and shows the word and what it should be next to Try, with Copy.
- Not in our dictionary is a word we don't know. It could be a typo, or a name or a brand.
- The words around it. Each finding shows the sentence the word is in, with the word marked, so you can see at a glance whether it's a slip or a name. For a name on a staff card, it shows the lines around it instead, such as the person's role.
- Looks like a name. A word set out like a person's name, for example on a team page, says so and offers no replacement, because changing a name to the nearest dictionary word is never right.
- It's correct stops that word being flagged anywhere on this project, on every later run. To hide just one finding instead, choose More, then Ignore.
- Your site's own words are learned. A word in the names of your pages, and a capitalised name used on 3 or more pages, such as a place or product name, are usually not flagged. A word used once that we don't know still is, and so is a word that looks like a slip of a real word, such as "Contcat", even in a page name, so you catch the typo.
Page review
The other read-through check, Page review, makes suggestions about each page's search and content, each titled Search or Content, such as a description that doesn't say what the page offers. It is also marked Beta.
Until then, Spelling and grammar and Page review could finish with nothing to show even when the read-through had found things. That is fixed. If either check showed nothing on an earlier run, choose Run on it again.
The read-through is done by an AI service, and only while AI tools are switched on for your workspace in Settings. Only the page itself is sent, to check it: its words and headings and, for Page review, the behind-the-scenes part of the page, such as its title, its description and any scripts placed there. Our privacy policy lists the services we use.
Drafted fixes, one per line
For page titles, search descriptions, image descriptions (alt text) and broken links, each finding in the list carries its own fix:
- Now shows the words on the page today, where there are some.
- Suggested (Try, for a broken link) shows what we'd put instead, with its own Copy.
- An image is named by its file name, such as summer-fete.jpg, rather than its whole web address. Press the name to open the picture in a new tab. A picture built into the page itself says it has no file name.
In the New view, a check with two or more drafted fixes starts with Drafted fixes, ready to paste, how many there are and Copy all, which copies every one of them page by page. A long list scrolls inside its own box, so the page doesn't grow by dozens of rows. Check each fix reads right for its page before you paste it.
Broken links
A link to a page that doesn't exist would land your client on a missing page. Before a link on a live website counts as broken, we ask for the page again the way a person's browser would, and a link behind a security check is never reported as broken.
- When there's a close match, such as a page whose address differs by a typo, the finding suggests that address to use instead.
- When there isn't, the finding offers Send visitors to: a list of your site's working pages to choose from. The closest match, such as /contact-us for a missing /contact, comes first and says it is the closest match, but nothing is chosen for you.
- Once you choose a page, the finding shows the new address to put in the link, with Copy, or on a live Squarespace site, the URL mapping line for it. Your choice lasts while the page is open, so copy it before you leave.
On a live Squarespace site, the broken links come with URL mappings to paste into Squarespace: one line for each broken link that has a suggestion or a page you chose in Send visitors to, written the way Squarespace expects, for example /old-page -> /new-page 301, with Copy. In Squarespace, open Settings, then Developer tools, then URL mappings, paste the lines and press Save. A mapping only works once the old address is no longer a live page, so delete or disable that page first, or fix the link on the page instead.
Image descriptions (alt text)
Alt text is what a screen reader says in place of a picture. A good one says what the picture shows and what it is for on the page, and a picture that is only decoration should have an empty one. So a description is drafted only from real context on the page, and each draft says where it came from:
- the picture's caption;
- the name and role next to it, as on a staff card, such as "Sam Taylor, Youth Worker";
- the link or heading that goes with that one picture;
- a file name, only when it is made of several real words.
When there is nothing like that, there is no suggestion, because a confident wrong description is worse than none. The finding asks you to describe what the picture shows, or to leave it empty if it's only decoration. Where a picture's file name says nothing, such as IMG_2041.jpg, the check adds one tip: a descriptive file name, like summer-fete-on-the-green.jpg, also helps the picture show up in Google Images.
Some site builders write two descriptions on one picture. We read the first one, as a browser and a screen reader do.
Text that is hard to read
Text contrast is a page load check. It measures the colour of the text against the colour really behind it. The general advice is said once above the list, and each finding shows the text and a colour to try, with Copy. It is marked Beta.
- Before and after. In the New view, each finding shows the text as it is now, in its measured colours, beside the same text in the suggested colour, each with its contrast in words, such as "3.2 to 1". The usual minimum for body text is 4.5 to 1, and the figure is rounded down, so text just short of it never reads as passing.
- Light text on a filled button. When white or light text sits on a coloured button or badge, the suggestion is a darker background in the same colour, shown as Try background, that keeps the button's text colour, because that is part of the design. Dark text on a button gets a text colour suggestion, like any other text.
- Text over a photo has no single colour behind it, so it gets a quiet note instead of a colour: check it reads clearly on every screen size. A darker overlay or a text shadow helps.
Where to fix it on Squarespace
On a Squarespace site, many checks add a line saying where to make the change in Squarespace, for example: in Pages, hover over the page, click the gear icon, open SEO and fill in the SEO description. Only steps we're sure of are shown.