---
title: "Checks before publishing"
description: "What litetile checks before a publish: the problems that stop it, the search warnings that never block it, and what to do about each message."
url: "https://www.litetile.io/docs/publishing/checks"
lang: "en"
---

At the end of this page you know which problems stop a publish, which only warn, and how to clear each one.

When you open a publish dialog, litetile checks every selected item. A problem that would break the live site stops the publish. A search issue only warns: "Warnings never block publishing."

## What stops a publish

An item with a blocking problem is marked **Needs a fix**. The dialog says "Uncheck or fix the item marked Needs a fix." and the publish button stays off while it is selected. Choose **Open block** or **Go to block** to jump to the problem in the editor, or uncheck the item and publish the rest.

What stops a publish

- Message
- Why
- What to do

- A block has a missing or invalid value. Fix it, then publish again. A required field of a block (a section of the page) is empty or holds a value the block no longer accepts Open the block and fill in or correct the field
- A block is no longer available. Remove it, then publish again. The page holds a block that litetile no longer offers Delete the block and add another one
- Two pages share one address. Rename one, then publish again. Two pages would publish at the same address Change the Slug or the Parent of one of them
- A video on this page is still being prepared. Publish again once it is ready. An uploaded video is still being processed Wait a few minutes, then publish again
- A video on this page could not be prepared. Choose another video, then publish again. An uploaded video could not be processed Choose another video for the block
- This page holds more than 10 blocks. Remove blocks or upgrade. On the Free plan a page publishes with up to 10 blocks Remove blocks, or move to Studio
- This page is in a language the site no longer has. Shown when you roll back to a release that holds a language you removed since Choose another release, or add the language again

Each item lists up to five problems at a time; fix them and open the dialog again to see any others.

### Other reasons a publish cannot start

Other reasons a publish cannot start

- Message
- What to do

- Publishing needs a verified email address. Open the link in the email litetile sent you, or use Resend email on the dashboard
- The live site would hold more pages than this site's plan allows. Also select the removals of trashed or unpublished pages, or upgrade
- Select at most 200 pages Uncheck some pages and publish them in a second release
- Select at least one item to publish. Tick at least one item
- This site is suspended, so it cannot be published. Read the notice on the dashboard; it says how to contest the decision

### When something changed meanwhile

If an item started to need a fix between opening the dialog and choosing **Publish**, the dialog says "Something changed before publishing" and "A selected item now needs a fix, so nothing was published. Uncheck it or fix it, then publish again."

## What only warns

These appear beside the page in the dialog, as a **Warning** or a **Notice**, and in the editor's **SEO** panel. You can publish with them.

What only warns

- Message
- Kind

- The page has no description. Add one so search results can summarise it. Warning
- No block gives this page a main heading. Add one, such as a hero. Warning
- This image has no alternative text. Add one so screen readers and search engines can describe it. Warning
- The home page asks search engines not to index it, so the site may not show in search results. Warning
- The title is 72 characters long. Keep it to 60 so search results show it whole. Notice
- The description is 30 characters long. Aim for 50 to 160. Notice
- This page has 2 main headings. Keep one, and remove or change this block. Notice
- The block Spring offer is not live: this page publishes without it until the block is published. Warning

The numbers and names are your page's own. For how to fix the search warnings, see [Titles, descriptions and checks](https://www.litetile.io/docs/seo-and-ai/search-settings). The last one is about a global block that has never been published: select that block in the same dialog and the warning goes away.

A missing image or font never stops a publish.

## If publishing fails after it starts

Rarely, a publish passes the checks and then fails while the site is rendered. The live site does not change. The dialog shows **Failed**, the **Releases** screen lists the release as **Failed**, and the site's **Notification email** receives a message.

If publishing fails after it starts

- Message
- What to do

- A block could not be shown. Fix its content, then publish again. Open the page in the editor; the block shows "This block could not be shown. Fix its content or remove it."
- Some content no longer fits its block. Fix it, then publish again. Check the blocks of the selected pages for empty or changed fields
- Two pages share one address. Rename one, then publish again. Change the Slug of one page
- The site could not be saved online. Publish again. Publish again
- Publishing failed. Publish again. Publish again
- Publishing was interrupted. Publish again. Publish again
- Publishing could not start. The live site did not change. Publish again; if it keeps happening, write to support@litetile.io

If the same message comes back after you publish again, write to support@litetile.io with the time it happened.
