> For the complete documentation index, see [llms.txt](https://docs.xibosignage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xibosignage.com/kb/resolving-common-issues/my-scheduled-layouts-are-not-working.md).

# My Scheduled Layouts are not working?

A **Layout** must meet the following criteria before it will be added to a Schedule:

1. It must be completely downloaded
2. All dependent resources must be downloaded
3. None of the dependent resources are in the faultlist
4. It is in its Scheduled window (from date/time and to date/time)
5. If there are any other Priority Layouts, it must be the same or higher Priority
6. The Layout can be parsed and doesn’t contain any invalid items
7. If none of the above is true, the Default Layout is tested against criteria 1 to 3.
8. If the Default Layout cannot be played the splash screen is shown.

#### Failing Test 6 <a href="#p-58399-failing-test-6-3" id="p-58399-failing-test-6-3"></a>

Test 6 can be failed in 2 ways:

1. **Minor fail** - the Layout is removed from the Schedule until the next time the Player checks its Schedule with the server.
2. **Major fail** - some Media files on the Layout will be blacklisted and will remain faultlisted until the Player is restarted.

### Solution: <a href="#p-58399-solution-4" id="p-58399-solution-4"></a>

The most common cause for a Layout Schedule to be “missed” is that the current running Layout is still in the Schedule and contains a long-running Media item (items with a high duration). This Layout will need to finish before the new Layout can start.

#### The following is suggested to check against criteria 1- 6: <a href="#p-58399-the-following-is-suggested-to-check-against-criteria-1-6-6" id="p-58399-the-following-is-suggested-to-check-against-criteria-1-6-6"></a>

* **Criteria 1 and 2** - use the **Player Status Screen** - **CMS Status** and check the entry for **Required Files**.&#x20;
* More specific information regarding missing resources / files can be checked using the **Manage** page for that [Display](https://xibo.org.uk/manual/en/displays.html) in the CMS.
* **Criteria 3** - use the **Player Status Screen** and check the entry for Faultlist. This will list the Media ID and Media format.

  **Please note:** Faultlisted media entries are not available on the Windows Player Status Screen.
* **Criteria 4 and 5** - check the Agenda View and / or Edit Event and check form fields are as expected.

**Criteria 6** - Use the Player Logs to identify invalid Media files and empty Regions.

### Further Info: <a href="#p-58399-further-info-7" id="p-58399-further-info-7"></a>

The Status Screen also provides “Schedule Status” indicators which contain lists of Layout ID’s (as seen in the CMS):

1. **All Layouts** - All Layouts the Player has been informed of, including the Default Layout. Items with a \* are not Scheduled.
2. **Scheduled Layouts** - Layouts from “All Layouts” that meet criteria between 1 and 5
3. **Valid Layouts** - Layouts in “Scheduled Layouts” that pass test 6.
4. **Invalid Layouts** - Layouts in “Scheduled Layouts” that fail test 6.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xibosignage.com/kb/resolving-common-issues/my-scheduled-layouts-are-not-working.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
