Lógica

Bloco em loop

Repetir as mesmas perguntas para cada marca, produto ou item, sem montar uma página para cada um.

Atualizado em 17 de agosto de 2026

O problema que ele resolve

Você quer avaliar cinco marcas. Cada marca tem as mesmas três perguntas.

Sem o loop, você monta 15 perguntas. Você escreve o nome da marca em cada uma. Você cria uma regra de exibição para cada grupo. Depois o cliente pede uma marca a mais, e você repete todo o trabalho.

O bloco em loop resolve isto. Você monta as três perguntas uma vez, e a plataforma as repete para cada marca.

Como o loop funciona

O bloco em loop tem uma fonte. A fonte diz quais itens entram na repetição.

A plataforma repete as páginas do bloco, uma vez por item. Em cada volta, o marcador {{loop.label}} mostra o nome do item da vez.

A pessoa vê a mesma página várias vezes, com um nome diferente em cada uma. As respostas ficam separadas por item nos resultados.

Fonte	Quando usar
Itens de uma pergunta	A pessoa escolhe as marcas antes. Você repete pelas escolhas dela.
Catálogo próprio	Você define a lista. A plataforma sorteia alguns itens para cada pessoa.

Passo 1: crie a pergunta que alimenta o loop

Use este passo somente para a fonte "Itens de uma pergunta".

Adicione uma pergunta que produza uma lista de itens.
Escreva o enunciado: "Quais destas marcas de café você conhece?".
Escreva uma alternativa por marca.

Qualquer pergunta que dê uma lista serve de fonte. O que muda é quais itens entram na repetição:

Tipo da pergunta	Os itens que a repetição usa
Múltipla escolha, tagbox, imagem	as que a pessoa marcar, as que ela NÃO marcar, ou todas da lista
Escolha única, lista suspensa	todas as alternativas da lista
Ordenação (ranking)	as que ela ordenou, na ordem que ela deu
Soma constante, orçamento	as que receberam um valor maior que zero, da maior para a menor
Matriz	as linhas que ela respondeu

Escolha única repete pela lista inteiraA pessoa marca uma alternativa só, então repetir "pelo que ela marcou" seria uma volta só. Ali a repetição percorre todas as alternativas — serve para perguntar a mesma coisa sobre cada item de uma lista fixa, independentemente da resposta.

Passo 2: peça a repetição, na própria pergunta

No cartão da pergunta do passo 1, embaixo das alternativas, clique em ↻ Repetir perguntas por item. O painel abre ali mesmo, no cartão, com a sua lista à vista.
Em Repetir por, escolha quais itens entram. O campo só aparece quando há mais de uma leitura possível para aquele tipo de pergunta.
Escolha o tipo da pergunta que se repete.
Escreva o enunciado. Ele já vem com o nome do item; o botão + nome do item insere o nome onde está o cursor.
Confira a linha embaixo do campo: ela mostra a frase pronta, com o primeiro item da sua lista. É assim que a pessoa vê.
Escreva um número em No máximo, itens por pessoa. A linha seguinte diz quantas telas a mais isso gera para quem responde.
Clique em Criar.

Muitas telas com uma pergunta só? Use uma matrizDez marcas com uma escala de 0 a 10 viram dez telas quase iguais, e quem responde abandona. O certo ali é uma pergunta de matriz: as marcas nas linhas, a escala nas colunas, tudo numa tela. A repetição compensa quando você faz duas ou mais perguntas sobre cada item, ou quando a pergunta não cabe numa grade — uma resposta aberta, uma imagem, um vídeo. O painel avisa quando a sua configuração cai nesse caso.

O painel abre dentro do próprio cartão, com a sua lista à vista. A linha em negrito mostra a frase pronta, usando o primeiro item da lista.

A página que repete nasce logo depois deste bloco, com a pergunta pronta. Você não precisa escrever o marcador à mão, nem procurar o recurso em outro menu.

Sem o nome do item, as repetições ficam iguaisA pessoa veria a mesma frase duas ou três vezes seguidas, sem saber de qual item você está falando. O aviso embaixo do campo aparece quando o enunciado não cita o item.

Passo 3: mais perguntas sobre o mesmo item

A repetição cobre a página inteira, e não só a primeira pergunta.

Vá até a página que nasceu no passo 2.
Acrescente perguntas ali, como em qualquer página.
Nos enunciados, escreva {{ e escolha {{loop.label}} na lista de marcadores.

Todas as perguntas daquela página se repetem juntas, uma vez por item.

A lista de marcadores só oferece {{loop.label}} dentro de uma repetição. Os outros marcadores estão em Variáveis.

Passo 4: confira na prévia

Clique em Prévia.
Marque duas marcas na pergunta do passo 1.
Avance.

Você vê a página do bloco duas vezes. Cada volta mostra o nome de uma marca.

O máximo de itens

O campo No máximo, itens por pessoa limita as voltas. Ele começa no tamanho da sua lista: todo item marcado é avaliado.

A plataforma sorteia os itens quando a pessoa marca mais itens que o máximo. O sorteio é estável: a pessoa vê os mesmos itens se recarregar a página.

Um máximo baixo protege a duração da entrevistaUma pessoa que marca dez marcas não responde dez vezes as mesmas três perguntas. E a base de cada marca se completa somando as pessoas.

Desligar a repetição

A faixa Em loop, no alto do bloco, tem o botão remover.

As perguntas continuam onde estão, e deixam de se repetir. Elas não somem.

O nome do item sai dos enunciadosFora de uma repetição, o marcador do item fica em branco na tela: "O que você acha de ?". Por isso a Upinion o remove ao desligar, e o aviso diz quantos enunciados serão mexidos antes de você confirmar.

O catálogo próprio

Use esta fonte quando a lista não vem de uma pergunta. Por exemplo: 60 modelos de carro, dos quais cada pessoa avalia 8.

Este caminho fica no assistente completo, e não no botão da pergunta: aqui não existe uma pergunta que liste os itens.

Abra o menu Estrutura, no alto da tela.
Clique em + Bloco em loop.
Clique na aba Catálogo próprio (lista fixa).
Escreva os itens no campo de texto, um item por linha.
Escreva um número em Máximo de itens avaliados por pessoa.
Clique em Criar bloco em loop.

Cada linha tem até três partes, separadas por |:

Modelo A | 3 | SUV
Modelo B | 1 | Sedã
Modelo C

Parte	O que é	Obrigatória
Rótulo	O nome que a pessoa lê	Sim
Peso	A plataforma sorteia com mais frequência o item de peso maior	Não
Categoria	O grupo do item	Não

O campo Garantir ao menos N categorias distintas no sorteio força variedade. Escreva 0 para não exigir nada.

Cada item do catálogo aceita uma foto. A foto aparece sozinha no topo da página.

Editar ou remover o loop

O bloco em loop mostra uma faixa, que começa com "Em loop:".

Clique em editar na faixa para mudar a fonte ou o máximo.
Clique em remover na faixa para desfazer o loop.

O bloco continua no questionário depois de remover o loop. As páginas dele passam a aparecer uma vez só.

O menu Lógica, na barra de ferramentas, também mostra o loop. Ele aparece na primeira página do bloco, com a fonte dos itens.

Quais itens entram na repetição

Por padrão, o loop repete pelas alternativas marcadas. Isto atende quase todo estudo.

A plataforma aceita outras regras, e o construtor ainda não as oferece na tela. Elas se escrevem no arquivo USL do questionário, e servem a casos como:

repetir pelas alternativas não marcadas, para perguntar por que a pessoa não conhece uma marca;
repetir por todas as alternativas, quando todos avaliam a lista inteira;
repetir pelas primeiras de um ranking;
embaralhar a ordem das voltas.

Fale com o time técnico para usar uma dessas. Leia Importar um questionário pronto.

O que o loop não faz

Não há loop dentro de loop. O loop repete um bloco, e um bloco contém páginas, e não outros blocos. Para avaliar dois níveis (marca, e depois produto da marca), monte dois blocos em loop seguidos.
O loop não muda as perguntas. Toda volta mostra as mesmas perguntas. Para mudar uma pergunta conforme o item, use uma regra de exibição.
O loop não soma as respostas. Cada volta grava a resposta dela, separada por item.

Para avaliar um item só, sorteado entre os que a pessoa marcou, o caminho é mais curto: use uma variável de sorteio, sem montar um bloco em loop. Ver Sorteio de item.

Perguntas frequentes

O marcador aparece como texto na prévia.
Confira se a pergunta está dentro do bloco em loop, e se você escolheu {{loop.label}} na lista de marcadores.

A pessoa não marcou nenhuma marca. O que acontece?
O bloco não tem item nenhum para repetir, então a pessoa não passa por ele.

Dá para o loop repetir por uma lista que vem no link?
As fontes da tela são a pergunta anterior e o catálogo próprio. Para o resto, fale com o time técnico.