> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Bloco de envio de arquivos em funis de quiz

> Saiba como usar o bloco File Upload nos funis de quiz do LanderLab. Defina os tipos de arquivo aceitos, os limites mínimo e máximo de arquivos e as regras de validação, e colete arquivos dos usuários em qualquer etapa.

O bloco File Upload (envio de arquivos) permite coletar arquivos dos usuários diretamente em uma etapa do funil de quiz. Você pode adicioná-lo a qualquer etapa, configurar quais tipos de arquivo são aceitos, definir quantos arquivos os usuários podem enviar e tornar o envio obrigatório para que eles possam continuar.

***

## O que é o bloco File Upload?

O bloco File Upload é um bloco de quiz que você adiciona a uma etapa do seu funil. Quando o usuário chega a essa etapa, ele vê uma área de envio com recurso de arrastar e soltar, onde pode enviar um ou mais arquivos.

Ele é útil quando você precisa de documentos comprobatórios, imagens ou mídias de um lead como parte do seu fluxo de qualificação. Por exemplo: um documento de identidade, um arquivo de portfólio, um contrato ou uma foto de um problema com um produto.

***

## Como adicionar o bloco File Upload a uma etapa

<Steps>
  <Step title="Abra seu funil de quiz">
    Acesse, no LanderLab, o funil de quiz que você quer editar.
  </Step>

  <Step title="Vá até a etapa certa">
    Abra a etapa em que você quer coletar arquivos ou crie uma nova etapa.
  </Step>

  <Step title="Adicione o bloco">
    Clique em **Add Block** dentro dessa etapa e selecione **Upload** na lista de blocos.
  </Step>

  <Step title="Configure">
    O bloco é adicionado à sua etapa. Clique nele para abrir o painel de configurações e configurá-lo.
  </Step>
</Steps>

***

## Configurações do bloco

Depois que o bloco Upload estiver na sua etapa, clique nele para abrir o painel de configurações à esquerda.

### Geral

| Campo           | O que faz                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Name**        | Identificador interno do bloco. Usado nos dados do lead e nas referências da lógica do quiz.            |
| **Label**       | O pequeno rótulo exibido acima da área de envio na etapa publicada.                                     |
| **Title**       | A chamada principal exibida dentro da área de envio (por exemplo, "Solte seu arquivo aqui ou clique").  |
| **Description** | Texto de apoio exibido abaixo do título dentro da área de envio (por exemplo, "Aceita png, jpeg, pdf"). |

### Configurações

| Campo           | O que faz                                                                           |
| --------------- | ----------------------------------------------------------------------------------- |
| **Min Files**   | O número mínimo de arquivos que o usuário deve enviar. O padrão é 1.                |
| **Max Files**   | O número máximo de arquivos permitidos.                                             |
| **Allow Types** | Os formatos de arquivo aceitos. Você pode selecionar vários tipos no menu suspenso. |

#### Tipos de arquivo aceitos

Você pode permitir qualquer combinação dos seguintes formatos:

<AccordionGroup>
  <Accordion title="Imagens">
    JPEG, PNG, WebP, GIF, SVG, HEIC
  </Accordion>

  <Accordion title="Documentos">
    PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, CSV, TXT
  </Accordion>

  <Accordion title="Vídeo">
    MP4, MOV, WebM
  </Accordion>
</AccordionGroup>

<Warning>
  O tamanho total dos arquivos enviados não pode ultrapassar 30 MB por envio
</Warning>

***

## Validação

Na seção **Validations**, você pode ativar a opção **Required**. Quando ela está ativada, o usuário não consegue passar para a próxima etapa até enviar pelo menos o número mínimo de arquivos.

Você também pode definir uma **Error Message** personalizada, exibida se o usuário tentar continuar sem enviar arquivos.

***

## Outras opções de configuração

O bloco Upload também oferece as mesmas opções padrão disponíveis nos outros blocos de quiz:

| Seção          | O que controla                                 |
| -------------- | ---------------------------------------------- |
| **Spacing**    | Ajusta o padding e as margens.                 |
| **Appearance** | Controla a aparência visual do bloco.          |
| **Visibility** | Exibe ou oculta o bloco com base em condições. |

***

## Como o usuário vê o bloco

Quando o usuário chega à etapa, ele vê uma área de envio bem identificada, com o título e a descrição que você configurou. Ele pode arrastar e soltar arquivos diretamente na área ou clicar para procurar e selecionar arquivos do dispositivo.

***

## Dicas

<Tip>
  Deixe claro no campo **Description** quais formatos e tamanhos são aceitos. Isso reduz a confusão dos usuários e os envios com falha.
</Tip>

<Tip>
  Se você precisa de apenas um arquivo, defina **Min Files** e **Max Files** como `1` para simplificar a experiência.
</Tip>

<Tip>
  Use a opção **Required** quando o arquivo for essencial para a qualificação do lead. Deixe-a desativada se o envio for opcional.
</Tip>

<Tip>
  O valor do campo **Name** se torna a chave nos dados do seu lead. Dê a ele um nome claro, como `portfolio_upload` ou `id_document`, para que seja fácil identificá-lo no seu painel de leads.
</Tip>

***

## Relacionados

<CardGroup cols={2}>
  <Card title="Gerenciar etapas" icon="list-ol" href="/pt-BR/features/quizzes/managing-steps">
    Saiba como adicionar, reordenar e gerenciar as etapas do seu funil de quiz.
  </Card>

  <Card title="Blocos do quiz" icon="puzzle-piece" href="/pt-BR/features/quizzes/get-started">
    Conheça todos os blocos disponíveis que você pode adicionar a uma etapa do quiz.
  </Card>

  <Card title="Validação" icon="circle-check" href="/pt-BR/features/quizzes/get-started">
    Entenda como definir regras que controlam quando os usuários podem avançar.
  </Card>

  <Card title="Condições" icon="code-branch" href="/pt-BR/features/quizzes/get-started">
    Use lógica condicional para exibir ou ocultar blocos com base nas respostas do usuário.
  </Card>
</CardGroup>