Como exportar arquivos da Shopify usados por metaobjetos

Para exportar arquivos da Shopify usados por metaobjetos, abra Export content files no Export Product Images, defina a referência do arquivo como Files used in metaobjects, escolha um tipo de metaobjeto (ou qualquer um), clique em Preview files e depois em Export files. O ZIP contém só os arquivos para os quais suas entradas de metaobjetos apontam, como imagens de amostras ou ícones.

Por que não dá para fazer isso no admin da Shopify?

A página Arquivos do admin da Shopify permite filtrar por onde um arquivo é usado, mas oferece só duas opções: usado em produtos, ou outros. Não há como dizer «mostre só os arquivos que os metaobjetos usam». Também verificamos a Admin API em setembro de 2026: a busca de arquivos aceita um valor used_in para produtos e para nenhum uso, enquanto outros valores devolvem uma lista vazia sem erro.

A resposta está, então, nos próprios metaobjetos. Um arquivo não tem uma lista dos metaobjetos que apontam para ele, mas uma entrada de metaobjeto tem um campo que contém o arquivo. O app lê esses campos e os cruza com os seus arquivos. Por isso você pode escolher um tipo de metaobjeto na exportação.

De quais arquivos de metaobjetos estamos falando?

Pense em tudo o que você construiu com metaobjetos e que carrega uma imagem ou um documento:

• Amostras de cor com uma imagem por cor
• Fichas de marca ou designer com um logotipo
• Guias de tamanhos com uma imagem ou PDF
• Conjuntos de ícones para selos de produtos

Só tipos de metaobjeto com um campo de arquivo (uma referência de arquivo ou uma lista de referências de arquivo) podem conter arquivos, então a exportação só oferece esses tipos.

Como os exporto?

1. Abra Export content files.
2. Marque os tipos de arquivo que quiser: Include images, Include videos, Include 3D models, Include other files.
3. Em referências de arquivos, escolha Files used in metaobjects.
4. Escolha um tipo de metaobjeto, por exemplo o das suas amostras de cor, ou qualquer tipo para obter a união de todos.
5. Opcional: limite o intervalo de datas de envio.
6. Clique em Preview files. O resumo mostra quantos arquivos foram encontrados por tipo e o tamanho total.
7. Escolha o File name format (nome original ou texto alternativo) e o Folder name format (No sub folders, tipo de arquivo ou mês de envio).
8. Clique em Export files e baixe o ZIP quando o e-mail chegar.

Todas as opções estão no guia de Content > Files.

Posso exportar arquivos que nada usa?

Sim. Escolha Files not used anywhere como referência. É o conjunto que a maioria quer inspecionar antes de limpar o armazenamento. Se pretende apagar esses arquivos depois, exporte-os antes para ter um backup. Nosso site irmão tem um guia sobre apagar arquivos sem uso.

Que nomes os arquivos terão?

Com Original name, você recebe o nome que a Shopify guarda, e dois arquivos diferentes com o mesmo nome na mesma pasta são numerados (swatch.png e swatch__(2).png). Com Alt text, o arquivo é nomeado pelo texto alternativo mais a extensão original, útil para amostras com texto alternativo descritivo. Um arquivo sem texto alternativo mantém o nome original.

A exportação altera a minha loja?

Não. O app pode ler seus arquivos e metaobjetos, e não pode editá-los nem apagá-los. Na primeira vez que você abre a exportação de arquivos de conteúdo, a Shopify pode pedir que você aprove as permissões de leitura.

Quantos arquivos posso exportar?

Cada arquivo no ZIP conta como um para o seu limite mensal: 100 no plano gratuito, 1.000 no Starter, 10.000 no Advanced e ilimitado no Premium. As pré-visualizações são grátis. Veja downloads e limites dos planos.

Instale o Export Product Images e rode a pré-visualização para ver quantos arquivos de metaobjetos a sua loja tem.