Theme logs
View validation, sync, and processing messages from your theme
Theme logs record what happens when your theme is processed — validation results, sync activity, deployment outcomes, and any warnings or errors that come up. Most editors won't look at theme logs day to day, but they're useful when something looks wrong on the live site or when coordinating with a theme developer.
When to check theme logs
- After your theme developer pushes an update and you want to confirm it deployed cleanly.
- When a page on the live site shows a missing block, a broken layout, or a fallback theme.
- When the theme's health indicator shows Warning or Critical in the Themes area.
- When you're rolling back a deployment and want to see why the previous version flagged.
What a log entry shows
Each log entry includes:
- A type — validation, sync, deployment, or processing.
- A timestamp.
- A severity — info, warning, or error.
- A message — what happened, in plain text.
- Where the message came from inside the theme — the block, template, or settings group it relates to.
Working with your theme developer
Logs are the most useful artefact to share with a theme developer when something's going wrong. A screenshot of the relevant log entries usually tells the developer where to look, even before they reproduce the issue themselves.