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 5 de novembro 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 que a pessoa vê em cada volta

Embaixo da barra de progresso, a página da repetição diz em que volta a pessoa está: "Item 2 de 5". O contador aparece quando há dois itens ou mais.

O contador não mostra o nome do item. Assim ele serve também à foto sem legenda, quando a pergunta pede para a pessoa reconhecer o modelo.

Para escrever o número no enunciado, use {{loop.index}} (a volta da vez) e {{loop.total}} (o total de voltas da pessoa). Por exemplo: "Marca {{loop.index}} de {{loop.total}}: {{loop.label}}".

Num questionário sem barra de progresso, o contador também não aparece.

Respostas dadas antes da repetição

Dentro da repetição, os marcadores e as regras de exibição enxergam as respostas das páginas anteriores ao loop. "A sua marca preferida é {{Q1}}" mostra a resposta da pessoa em todas as voltas.

A resposta de uma volta não aparece em outra: cada item tem as suas.

Voltar dentro da repetição

Quando o questionário tem o botão Voltar, voltar leva à volta anterior com o nome do item dela e com a resposta que a pessoa deu ali. A correção fica gravada nesse item. A prévia sempre tem o botão Voltar.

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 na tabela, um item por linha. Clique em + Adicionar item para ter mais uma linha.
Escreva um número em Máximo de itens avaliados por pessoa.
Clique em Criar bloco em loop.

A tabela tem três colunas:

Coluna	O que é	Obrigatória
Rótulo	O nome que a pessoa lê	Sim
Peso	A chance do item no sorteio. Em branco, vale 1. Um item de peso 3 tem três vezes a chance de um item de peso 1	Não
Categoria	O grupo do item, para a mistura de categorias	Não

Você já tem a lista numa planilha ou num documento? Copie a lista e cole no primeiro rótulo. Cada linha vira um item. As colunas da planilha entram, nesta ordem, como rótulo, peso e categoria.

Embaixo dos campos, uma frase diz o efeito da configuração. Por exemplo: "Cada pessoa vê 3 dos 12 itens, sorteados com mais chance para os de peso maior."

O campo Mínimo de categorias diferentes por pessoa força variedade. Com 2, cada pessoa vê itens de pelo menos duas categorias. Escreva 0 para não exigir nada.

Não lembra o que um campo faz? Passe o mouse sobre o ? ao lado do nome do campo.

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, quais itens entram, o máximo ou a ordem. O assistente abre com o que está gravado, mesmo numa repetição que nasceu no botão da pergunta.
Clique em remover na faixa para desfazer o loop.

Ao salvar, o assistente muda só o que você mudou na tela. O resto da repetição fica como estava.

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.

O campo Repetir por oferece as outras regras, no botão da pergunta e no assistente. Ele mostra só as regras que servem ao tipo da pergunta (ver a tabela do passo 1). Elas 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.

Numa ordenação, o assistente mostra também Posições do topo que entram. Com 3, entram as três primeiras da ordem que a pessoa deu. Em branco, vale o máximo de itens.

No assistente, a caixa Embaralhar a ordem para cada pessoa sorteia a ordem das voltas. A ordem não muda se a pessoa recarregar a página.

Uma regra que veio de fora continuaUm questionário importado, ou montado por um agente, pode trazer uma regra que a tela não oferece para aquele tipo de pergunta. Por exemplo: as alternativas não marcadas numa escolha única. O assistente mostra essa regra em Repetir por e a mantém ao salvar.

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.