Troubleshooting · Developer docs

Troubleshooting

Grouped by symptom, never by module, because the person with the problem does not know which module has it. One hundred questions across ten pages, each answered with the causes in the order they usually turn out to be true.

Answer It is not showing up

My template change is not appearing on the site

Published

In order: it is not deployed (the commit is not on the branch that deploys to this environment; the environment's deploy log in the admin, and the ?v= hash on asset URLs in the page source, show what is deployed). It is the wrong file: the layout points at a different template path than the one you edited, or a site file with the same name overrides the one you changed (site templates win over the platform's). It is cached: a deploy clears the compiled templates, the page cache and the CDN, so after a deploy this is rarely it, but a change to content, or a template edited in place on a development server, can wait on the page cache; the Clear Cache action exists but is limited to super administrators. Someone else's editor uploaded over it: development servers with upload-on-save editors take the last save from any machine.

Shell 
curl -s https://dev.example.com/ | grep -o 'app.css?v=[0-9a-f]*'   # the deployed commit
git log -1 --format=%h origin/develop                              # what you think is deployed

More in It is not showing up

  1. My CSS or JS change is not appearing
  2. My layout does not appear in the picker when I create a page
  3. My component does not appear in the collection's add menu
  4. My template renders but every area is empty
  5. A new layout area is not showing on the editing form

Was this page helpful?

Your answer goes to the docs team.