Após fazer upload da versão atualizada de algum arquivo pertinente ao layout de seu site (CSS, JS ou mesmo imagens), a versão apresentada no front-end pode permanecer não sendo a mais recente.

Isso ocorre enquanto o template estiver em cache. A requisição a estes arquivos é feita com um parâmetro de versionamento, na qual o seu valor é um timestamp do arquivo original - exemplo, /arquivos/style.css?v=636492689128330000. Enquanto o timestamp for o mesmo, o arquivo será o mesmo.

A principal causa do cenário é que o template não sabe que um arquivo foi alterado, então seu cache não expira apenas com a atualização dos arquivos.

Em determinado template, atualizar um arquivo de CSS ou Javascript, fazendo novo upload com o mesmo nome, para que sobrescreva o antigo.

Observar que o parâmetro de timestamp na requisição não irá se alterar, e o conteúdo do arquivo será o mesmo.

Alterar os templates que chamam os arquivos atualizados é suficiente para revisar o timestamp, que então irá trazer a versão mais recente dos arquivos.

Uma sugestão, para facilitar o workaround toda vez em que se altera um arquivo do layout, é criar um subtemplate de controle de versão, que esteja presente em todos os templates usados na loja. Para o conteúdo deste subtemplate será suficiente um comentário HTML, com informações que serão atualizadas a cada versão de arquivos.

Ao alterar o subtemplate, todos os templates que fazem sua leitura serão atualizados, e junto disso, os arquivos.