Menu
Feedback
Comece aqui
Tutoriais
Portal do desenvolvedor

Problemas conhecidos
Diretivas de suporte
Troubleshooting

Perguntas frequentes
Comunicados
Tutoriais
Tutoriais
Explore tutoriais detalhados para operar sua loja VTEX.
Tutoriais
Storefront
Headless CMS
Mídia - Visão geral
Mídia - Visão geral
5 min de leitura

O Mídia é uma funcionalidade responsável por gerenciar os arquivos de mídia da sua loja, como imagens e vídeos. Para imagens, você pode fazer o upload e organizar arquivos de mídia de até 5 MB usando o Mídia nos seguintes formatos: png, jpg, gif, svg e webp. Para vídeos, você pode adicionar uma URL para o provedor de vídeo hospedado externamente, como YouTube ou Vimeo.

Para upload, os arquivos devem ter uma extensão em minúsculo, por exemplo, store.png, e tamanho de até 5 MB.

{"base64":"  ","img":{"width":1643,"height":638,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":45679,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Storefront/Headless%20CMS/midia-visao-geral_1.png"}}

Além disso, o Mídia está integrado ao Site Editor e ao Headless CMS, o que permite que ele seja acessado e gerenciado diretamente através de soluções de CMS da VTEX.

Neste guia, aprenda a:

Acessar o Mídia

Há três maneiras de acessar o Mídia no Admin:

  • Mídia: no VTEX Admin, acesse Storefront > Mídia.

  • Site Editor (para lojas que usam o Store Framework): no VTEX Admin, acesse Storefront > Site Editor, escolha um bloco que contenha uma imagem (por exemplo, Carrossel), e clique em Adicionar. Um painel do Mídia será aberto.

  • Headless CMS: no VTEX Admin, acesse Storefront > Headless CMS e escolha uma das páginas criadas, por exemplo, uma Página de Produto. Nas seções disponíveis, selecione uma na qual você possa adicionar uma imagem, por exemplo, Hero. Clique no componente de imagem do Hero e um painel do Mídia será aberto.

A seção disponível deve utilizar o media-gallery para aproveitar o Mídia. Para projetos FastStore, as seções que utilizam o widget media-gallery são Navbar and Hero.

Na imagem a seguir, confira a visão geral da interface do Mídia e as ações disponíveis para gerenciar seus arquivos de mídia:

{"base64":"  ","img":{"width":1503,"height":726,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":83397,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Storefront/Headless%20CMS/midia-visao-geral_2.png"}}

CampoDescrição
I - Campo de buscaPesquise os arquivos disponíveis no Mídia.
II - Ordenar porClassifique como os arquivos são exibidos na interface com base nos filtros: Mais recentes, Mais antigos, Nome (A-Z) e Nome (Z-A).
III - PaginaçãoNavegue pelas páginas de arquivos disponíveis.
IV - Modo de visualizaçãoEscolha o modo de visualização dos arquivos: Visualizar em lista ou Visualizar em grade.
V - Adicionar nova imagem ou vídeoCarregue um novo arquivo de sua máquina local.

Gerenciar arquivos no Mídia

Veja nas seções abaixo as ações disponíveis para gerenciamento de arquivos no Mídia:

Upload de imagens

No Mídia, você pode fazer upload de imagens nos seguintes formatos: png, jpg, gif, svg e webp, com um limite de tamanho de arquivo de 5 MB. Para fazer o upload da imagem da sua loja, siga estes passos:

  1. Na página ou no painel Mídia, clique em Adicionar novo(a) e clique em Imagem.

No painel Mídia disponível no Headless CMS e no Site Editor, você pode arrastar e soltar imagens.

  1. Escolha a imagem que deseja adicionar e clique em Abrir.

Lembre-se, o Mídia aceita os seguintes formatos: png, jpg, gif, svg, e webp, em minúsculo e com um limite de tamanho de arquivo de 5 MB.

  1. Depois que a imagem é carregada, uma mensagem de sucesso será exibida. Agora, você pode executar outras ações clicando em Mais ações (três pontos verticais) na miniatura da imagem e escolhendo uma das seguintes ações:
CampoDescrição
Pré-visualizarAbre a imagem em uma nova página.
Copiar URLCopia a URL da imagem para que você possa utilizá-la em outras seções da sua loja.
BaixarFaz o download da imagem para o seu computador.
ExcluirRemove a imagem do repositório.

Excluir a imagem apenas a removerá do repositório do Mídia. Se você adicionou a imagem em um componente Hero, por exemplo, a imagem continuará sendo utilizada neste componente. Porém, você não poderá usá-la em outros componentes.

Adicionar vídeos

Além de imagens, no Mídia, você também pode armazenar vídeos e, em seguida, usá-los em sua loja para criar apelo visual para os usuários.

  1. Na página Mídia, clique em Adicionar novo(a) e escolha Vídeo.
  2. No modal, preencha o nome e a URL do vídeo conforme necessário.
  • Nome do vídeo: adicione um nome para o vídeo que o ajude a identificá-lo melhor na galeria.
  • URL do vídeo: adicione a URL do vídeo.
  1. Clique em Adicionar vídeo.

Com o vídeo adicionado, você pode escolher o que fazer com ele clicando no menu na miniatura do vídeo:

  • Copiar URL: obtenha o endereço URL do vídeo para usar em sua loja por meio do Headless CMS.
  • Abrir vídeo: veja uma prévia do vídeo em uma nova aba do navegador.
  • Excluir: exclua o vídeo da sua galeria.

Adicionar um vídeo ao conteúdo no Headless CMS

Integrar conteúdo multimídia, como vídeos, no Headless CMS pode melhorar a experiência do usuário em seu site. Siga os passos abaixo para adicionar vídeos à sua loja.

  1. No VTEX Admin, acesse Storefront > Headless CMS.
  2. Selecione o projeto ao qual você deseja adicionar o vídeo.
  3. Escolha uma página para adicionar o vídeo, por exemplo, Página inicial.
  4. Com a Página inicial aberta, na aba Seções, adicione (+) uma seção que tenha o widget media-gallery, ex.: Hero.
  5. No Hero, preencha os seguintes campos:
  • Endereço URL: cole a URL que você copiou do Mídia.
  • Descrição do vídeo: descrição do vídeo para acessibilidade.
  1. Clique em Salvar.
  2. Se desejar verificar suas alterações antes de publicá-las, clique em Visualizar.

Cancelar um upload

  • Imagens

Se você estiver carregando uma nova imagem e não quiser continuar, clique no X sobreposto na miniatura da imagem para cancelar.

  • Vídeos

Depois de ter feito o upload do vídeo, passe o mouse sobre a miniatura do vídeo e clique no menu (). Selecione Excluir. Se este vídeo já estiver sendo usado em algum lugar da sua loja, ele permanecerá lá, mas não estará disponível para uso futuro.

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback