# Como funcionam os grupos de banners

<span style="white-space: pre-wrap;">O grupo de banners representa </span>**o espaço que os banners ocupam no site**. Ele não funciona apenas como uma pasta de organização, pois também define onde as peças serão exibidas, qual será a altura desse espaço e quais banners irão se alternar nele.

<span style="white-space: pre-wrap;">A lógica funciona da seguinte forma: o </span>**widget**<span style="white-space: pre-wrap;"> de uma página aponta para um </span>**grupo de banners**<span style="white-space: pre-wrap;">; o grupo define o espaço e suas dimensões; e os </span>**banners**<span style="white-space: pre-wrap;"> vinculados a esse grupo são exibidos conforme a ordem e o intervalo configurados.</span>

---

##### **Navegação no Módulo**

[![grupodebanner.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/grupodebanner.gif)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/grupodebanner.gif)

**Rotina:** <span style="white-space: pre-wrap;">Site &gt; Banners &gt; </span>**Grupos de Banners**

---

##### **Por que o grupo existe**

Os grupos de banners servem para reunir uma quantidade de banners e posicioná-los em um espaço específico do site através dos widgets configurados nas páginas.

Na prática, isso permite criar um grupo para cada área em que os banners deverão aparecer, como o topo da página inicial, uma faixa no meio da página, o rodapé ou um popup promocional.

Cada grupo possui suas próprias configurações e pode conter vários banners que serão exibidos alternadamente dentro daquele espaço.

<p class="callout warning">Como o grupo representa o espaço de exibição, alterar sua altura afeta todos os banners relacionados a ele. Caso as imagens tenham sido preparadas para uma determinada proporção e a altura seja modificada, os banners poderão aparecer cortados ou distorcidos.</p>

---

##### **Cadastrar um grupo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/T69image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/T69image.png)

Ao cadastrar um grupo de banners, são apresentados os seguintes campos:

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/ZvWimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/ZvWimage.png)

<table id="bkmrk-campodescri%C3%A7%C3%A3odescri"><colgroup><col></col><col style="width: 686px;"></col></colgroup><tbody><tr><th>Campo

</th><th>Descrição

</th></tr><tr><td>**Descrição do grupo**

</td><td><span style="white-space: pre-wrap;">Campo obrigatório. Define o nome utilizado para identificar o espaço, como </span> **Topo da home**<span style="white-space: pre-wrap;"> ou F</span>**aixa promocional**<span style="white-space: pre-wrap;"> .</span>

</td></tr><tr><td>**Altura**

</td><td><span style="white-space: pre-wrap;">Campo obrigatório, informado em pixels. Aceita valores entre </span> **50 e 500 px**<span style="white-space: pre-wrap;"> , sendo </span> **300 px**<span style="white-space: pre-wrap;"> o valor padrão. Define a altura máxima dos banners relacionados ao grupo.</span>

</td></tr></tbody></table>

---

##### **Banner popup**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/SeWimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/SeWimage.png)

O grupo também pode ser configurado para funcionar como um popup, fazendo com que o banner seja exibido sobre o conteúdo do site.

<table id="bkmrk-campodescri%C3%A7%C3%A3opopupq"><colgroup><col style="width: 104px;"></col><col></col></colgroup><tbody><tr><th>Campo

</th><th>Descrição

</th></tr><tr><td>**Popup**

</td><td>Quando habilitado, faz com que o grupo seja utilizado para exibição de banners em formato de popup.

</td></tr><tr><td>**Largura**

</td><td><span style="white-space: pre-wrap;">Campo exibido somente quando o popup está habilitado. É obrigatório nesse caso, informado em pixels e aceita valores entre </span> **150 e 700 px**<span style="white-space: pre-wrap;"> , sendo </span>**400 px**o valor padrão.

</td></tr></tbody></table>

O banner popup é exibido à frente do conteúdo da página e possui uma opção para que o visitante possa fechá-lo.

<p class="callout info">A configuração de largura é utilizada somente nos grupos definidos como popup. Nos grupos comuns, a largura do banner é determinada pelo espaço ocupado pelo widget na página, enquanto a altura é definida pelo próprio grupo.</p>

Ao gravar ou excluir um grupo de banners, o sistema atualiza as informações utilizadas pelo site e a relação de grupos disponíveis para configuração nos widgets das páginas.

---

##### **A listagem dos grupos**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/Zd4image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/Zd4image.png)

A listagem apresenta as principais informações dos grupos cadastrados:

<table id="bkmrk-informa%C3%A7%C3%A3odescri%C3%A7%C3%A3od"><colgroup><col></col><col style="width: 706px;"></col></colgroup><tbody><tr><th>Informação

</th><th>Descrição

</th></tr><tr><td>**Descrição**

</td><td>Apresenta o nome utilizado para identificar o grupo.

</td></tr><tr><td>**Altura do banner**

</td><td>Apresenta a altura configurada para o espaço do grupo.

</td></tr><tr><td>**Situação**

</td><td>Indica se o grupo está ativo ou inativo.

</td></tr><tr><td>**Data de criação**

</td><td>Apresenta quando o grupo foi cadastrado.

</td></tr><tr><td>**Data de alteração**

</td><td>Apresenta quando ocorreu a última alteração no cadastro.

</td></tr></tbody></table>

<span style="white-space: pre-wrap;">Ao selecionar vários grupos, fica disponível a ação </span>**Remover**.

---

##### **A ordem de montagem**

Para que um banner seja exibido corretamente no site, três elementos precisam estar configurados:

<table id="bkmrk-elementodescri%C3%A7%C3%A3ogru"><colgroup><col></col><col style="width: 705px;"></col></colgroup><tbody><tr><th>Elemento

</th><th>Descrição

</th></tr><tr><td>**Grupo**

</td><td>Define o espaço onde os banners serão exibidos e configura suas dimensões.

</td></tr><tr><td>**Banner**

</td><td>É a peça visual cadastrada e vinculada ao grupo correspondente.

</td></tr><tr><td>**Widget na página**

</td><td>Define em qual página e posição do site aquele grupo será exibido.

</td></tr></tbody></table>

O fluxo funciona da seguinte forma:

**Grupo → Banner → Widget da página**

<p class="callout info">Se qualquer uma dessas configurações estiver faltando, o banner não será exibido no site. Esse é um dos principais pontos a verificar quando um banner foi cadastrado, mas não aparece na página.</p>

---

##### **Perguntas frequentes**

<span style="white-space: pre-wrap;">➜ </span>**Qual a diferença entre grupo e banner?**<span style="white-space: pre-wrap;"> O grupo representa o espaço utilizado no site para exibição das peças, enquanto o banner é a imagem ou conteúdo exibido dentro desse espaço.</span>

<span style="white-space: pre-wrap;">➜ </span>**Preciso criar um grupo para cada banner?**<span style="white-space: pre-wrap;"> Não. Um mesmo grupo pode conter vários banners, que podem se alternar dentro do mesmo espaço.</span>

<span style="white-space: pre-wrap;">➜ </span>**Onde defino em qual página o grupo aparece?**<span style="white-space: pre-wrap;"> Essa configuração é realizada nas </span>**Páginas do Site**, através do widget de banner apontando para o grupo desejado.

<span style="white-space: pre-wrap;">➜ </span>**Posso mudar a altura depois?**<span style="white-space: pre-wrap;"> Sim. Porém, a alteração afeta todos os banners relacionados ao grupo e pode fazer com que imagens preparadas para outra proporção apareçam cortadas ou distorcidas.</span>

<span style="white-space: pre-wrap;">➜ </span>**Para que serve a largura?**<span style="white-space: pre-wrap;"> A largura é configurada somente nos grupos utilizados como popup. Nos grupos comuns, a largura é determinada pelo espaço ocupado pelo widget na página.</span>

<span style="white-space: pre-wrap;">➜ </span>**O que acontece ao excluir um grupo com banners?**<span style="white-space: pre-wrap;"> Como o grupo é uma informação obrigatória no cadastro dos banners, antes de realizar a exclusão é importante verificar quais banners estão relacionados a ele.</span>

<span style="white-space: pre-wrap;">➜ </span>**Criei o grupo e o banner, mas nada aparece no site.**<span style="white-space: pre-wrap;"> Verifique se existe um widget de banner configurado na página e apontando para o grupo correspondente. Sem essa configuração, o banner não será exibido.</span>