Prepare uma planilha para importação

Prepare seu arquivo Excel, CSV, JSON, TSV ou TXT para uso com o importador de planilhas.

Consulte nosso artigo Usar o importador de planilhas para saber como importar sua planilha para o ClickUp.

A disponibilidade de recursos e os limites variam conforme o plano e a função do usuário. Saiba mais

Formatos de arquivo compatíveis

Para usar o importador de planilhas, salve a planilha em um dos seguintes formatos de arquivo:

  • Excel: .xls, .xlsx
  • Valores separados por vírgula (CSV): .csv
  • JSON: .json
  • Valores separados por tabulação (TSV): .tsv
  • Texto: .txt

Há um limite de 10.000 linhas para planilhas importadas. Para arquivos maiores que isso, recomendamos dividir o arquivo em lotes com no máximo 10.000 linhas cada.

Campos de tarefa e campos personalizados compatíveis

Você pode importar dados para muitos campos de tarefa e campos personalizados existentes e novos. O único campo obrigatório é Nome da tarefa.

Formatação da planilha

Ao preparar os campos da sua planilha, lembre-se de que cada linha representa uma tarefa. Cada coluna representa uma propriedade dessa tarefa — seja um campo de tarefa, como Prioridade, ou um campo personalizado.

Use as regras de formatação a seguir para configurar os cabeçalhos, colunas, linhas, subtarefas e dados de data e hora da sua planilha.

Depois que sua planilha estiver formatada corretamente, faça o upload dela no importador de planilhas e mapeie essas colunas para os campos de tarefa, incluindo IDs e nomes de tarefas, subtarefas e subtarefas aninhadas.

Linha de cabeçalho da planilha

Inclua uma linha de cabeçalho. Cada cabeçalho de coluna deve ser único.

Ordem de colunas e linhas

As linhas podem estar em qualquer ordem, com apenas uma tarefa por linha.

Cada linha vira uma tarefa no ClickUp. Qualquer propriedade da tarefa pode ser adicionada como coluna na linha — por exemplo, status, prioridade, responsável, subtarefa, hora ou data.

Delimitadores

Separe vários itens em uma célula usando qualquer delimitador, como vírgulas ou barras verticais, sem espaços entre os itens e o delimitador. As colunas que aceitam vários itens incluem subtarefas, responsáveis e checklists.

Por padrão, o tipo de delimitador do importador de planilhas é a vírgula. Se sua planilha usar outros delimitadores, você pode selecioná-los na Etapa 2 do processo de importação.

Formatar subtarefas e subtarefas aninhadas

Se precisar importar subtarefas ou subtarefas aninhadas, adicione uma coluna de subtarefas à sua planilha. Você pode nomeá-la IDs de subtarefas, por exemplo, e separar as subtarefas com um delimitador. O padrão é vírgulas sem espaços.

A coluna de subtarefas indica quais tarefas importadas vão se tornar subtarefa ou subtarefa aninhada de uma das outras tarefas importadas.

Veja como formatar suas tarefas, subtarefas e subtarefas aninhadas na planilha:

ID da tarefa Nome da tarefa Status Prioridade IDs de subtarefas
1 Lançar campanha de marketing Conceito Normal 2,3
2 Criar página de destino Aberto Alta 4,5
3 Configurar análises Conceito Alta
4 Escrever copy principal Conceito Normal 6
5 Criar mockups Revisão Normal
6 Testar títulos com A/B Aberto Alta

No exemplo acima:

  • A linha um é uma tarefa chamada Lançar campanha de marketing.
    • A coluna IDs de subtarefas da linha um mostra o ID 2 (Criar página de destino) e o ID 3 (Configurar análises).
    • Isso significa que Criar página de destino e Configurar análises são subtarefas de Lançar campanha de marketing.
  • A linha dois é uma subtarefa chamada Criar página de destino.
    • A coluna IDs de subtarefas da linha dois mostra o ID 4 (Escrever copy principal) e o ID 5 (Criar mockups).
    • Isso significa que Escrever copy principal e Criar mockups são subtarefas aninhadas de Criar página de destino.
  • As linhas três, cinco e seis não mostram IDs de subtarefas.
    • Isso significa que Configurar análises, Criar mockups e Testar títulos com A/B não têm subtarefas nem subtarefas aninhadas.
  • A linha quatro é uma subtarefa aninhada chamada Escrever copy principal.
    • A coluna IDs de subtarefas da linha quatro mostra o ID 6 (Testar títulos com A/B).
    • Isso significa que Testar títulos com A/B é uma subtarefa aninhada de Escrever copy principal.

Quando importadas para uma visualização de Lista no seu Espaço de trabalho do ClickUp, as tarefas, subtarefas e subtarefas aninhadas ficarão assim:

Captura de tela mostrando as tarefas, subtarefas e subtarefas aninhadas da tabela como seriam importadas para uma Lista do ClickUp.

Formatar datas

Se precisar importar datas, adicione uma coluna de datas à sua planilha.

Na hora de importar, você escolherá um formato de data no importador de planilhas que corresponda ao formato usado na sua planilha.

Você pode usar os seguintes formatos de data na sua planilha:

Formato de data Exemplo aceito Exemplo que não será aceito
Ano-Mês-Dia 25-12-31
2025-12-31
25-Dec-31
2025-Dec-31
Dia/Mês/Ano 31/12/25
31/12/2025
31/Dec/25
31/Dec/2025
Mês/Dia/Ano 12/31/25
12/31/2025
Dec/31/25
Dec/31/2025
Ano/Mês/Dia 25/12/31
2025/12/31
25/Dec/31
2025/Dec/31

Estes formatos de data também são aceitos, independentemente do formato escolhido no importador de planilhas:

Formato de data Exemplo aceito
ISO 8601 2025-12-31T13:30:00.123Z
Carimbo de data/hora Unix (milissegundos) 1609428600000
Data longa do ClickUp (sem hora) Wednesday, December 31st 2025
Data longa do ClickUp (com hora) Wednesday, December 31st 2025, 3:30:00 pm +00:00

Formatar horários

Você pode especificar um horário incluindo-o junto com qualquer um dos formatos de data acima. Também é possível incluir uma coluna na sua planilha para qualquer um dos campos de hora aceitos pelo importador de planilhas — por exemplo, estimativa de tempo, tempo rastreado ou um campo personalizado.

Os seguintes formatos de hora são aceitos:

Formato Formato de hora Exemplo
mm/dd/aa hh:mm Horário de 24 horas 12/31/25 13:30
mm/dd/aa hh:mm Horário de 24 horas 12/31/25 03:30
Isso será interpretado como 3:30 am.
mm/dd/aa hh:mm Horário de 12 horas 12/31/25 03:30 am
mm/dd/aa hh:mm Horário de 12 horas 12/31/25 03:30 pm

Os dados de hora são interpretados como horário de 24 horas por padrão (00:00–23:59). Para usar o horário de 12 horas, adicione am ou pm conforme mostrado acima.

Você pode usar carimbos de data/hora Epoch/Unix/Posix:

Formato Data e hora Exemplo
Unix em milissegundos 12/31/20 3:30 pm 1609428600000

Você também pode usar o formato ISO 8601:

Formato Data e hora Exemplo
ISO 8601 12/31/25 3:30 pm UTC 2025-12-31T13:30:00.123Z