> For the complete documentation index, see [llms.txt](https://help.pixfizz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/calendar-troubleshooting.md).

# Calendar Troubleshooting

The problems that come up most often when building calendar templates, and what causes them.

The problems that come up most often when building calendar templates, and what causes them.

## Some days are greyed out and I do not want them to be

Those are the days that belong to the previous or next month. The month-grid sequence tags them `out-of-range`, and a calendar transformation on the design greys them.

Open **Calendar Transformations** on the design page and remove the rule that selects on the `out-of-range` tag. If you want the days gone rather than plain, change the action to `delete` instead of removing the rule.

## Some month names are not written out in full

Month names come from the platform's built-in translations, in the language the project is created in. If a month prints short, wrong or blank on every design on the site, the translation itself is the problem, not your design. Contact Pixfizz support with the site, the language and the month.

If only some months look right, check the **Calendar Transformations** array. A partial set of `set-text` rules overrides the months it covers and leaves the rest on the standard name, which reads as inconsistent output. Either cover all twelve months or remove the overrides. See [Month Names and Translations](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/month-names-and-translations.md).

## A transformation has no effect

Work through these in order:

1. The element has no **Element name**, or the name in the rule does not match it exactly.
2. The element is not bound to a date in the **Dates** panel. Date selectors only match date-bound elements.
3. The rule is not scoped to the right month, weekday or tag.
4. You are looking at the admin design tool. Transformations run when the project is built, not in the editor. Check in a built project or in the generated PDF.

## Cells are empty at the end of a month

Expected. An element bound to an index the sequence does not produce is deleted when the project is built, which is how a six-row grid handles a short month. If cells are empty in the middle of a month, the index numbering on the cells is wrong.

## The calendar starts on the wrong date

The start date chosen when the project was created is the input date for the whole definition, so check what was actually selected on the order before looking at the template.

## Weeks start on the wrong day

That is set in the month-grid sequence in the definition, not in the design. Swap the sequence for the other week-start version. See [Calendar Week Starting with Monday](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/calendar-week-starting-with-monday) and [Calendar Week Starting with Sunday](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/calendar-week-starting-with-sunday). Expect to check the grid layout afterwards.

## Pages come out in the wrong order

A definition with two loop sequences outputs the first sequence completely before starting the second. Odd and even months in separate sets produce six odd months then six even months. To alternate the design and keep January-to-December order, use one set and swap the artwork with calendar transformations.

## The printed file does not match the design after an edit

Editing a calendar element on an order that has already generated production files does not regenerate those files. Delete the existing generated file and force a refulfil from the order page in admin. Without that, the lab prints the pre-edit version.

## An element is unselectable behind the grid

Calendar pages stack many elements in the same place. Toggle the blocking layer off in the admin design tool, edit the element underneath, then turn the layer back on. Layer visibility toggled this way is an editing convenience only and does not change production output, which follows the `<layers>` block in the definition. See [PDF Layers](https://help.pixfizz.com/products-and-design/how-to-create-templates/pdf-layers).

## Start-date selector problems (Pixfizz CMS only)

> These apply only to storefronts running the Pixfizz CMS, with the Shopper 24 template. On your own storefront or an API integration the start date is supplied when the project is created.

**There is no start-date selector on the product page.** The Shopper product form renders it only when the product custom field `select_date` is set. Check the field is set on the product, and on a newly built site check the custom field definition exists at all. Without a selector the calendar silently falls back to the current date.

**The customer cannot choose the year they want.** The year selector takes `min` and `max` as offsets from the current year rather than absolute years, and the Shopper default is this year plus three. Widen the range if you sell further ahead than that.

**The start month is missing from the selector.** The product custom field `hide_select_month` hides it deliberately, leaving a year-only selector. Clear the field if the customer should be able to start the calendar in any month.

**The default offered is not the year you expected.** The selector rolls over on its own: from September onwards it offers January of next year, before September the following month of the current year. On products where a wrong start year means a reprint, set `admin/checklist/confirm-start-date` to `TRUE` so the customer has to tick a confirmation before Add to Cart is enabled.

## Related

* [Calendar Setup](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup.md)
* [Calendar Transformations](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/calendar-transformations.md)
* [Month Names and Translations](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/month-names-and-translations.md)
* [Build a 12-Month Wall Calendar](https://help.pixfizz.com/products-and-design/how-to-create-templates/calendar-setup/build-a-12-month-wall-calendar.md)
