--- title: "Importar arquivo ZIP do projeto" slug: "import-a-documentation-project" description: "Previously exported Document360 .zip files can be imported to any project. Importing a Document360 .zip file will import articles, categories, and files hosted in Drive." tags: ["Import & Export"] updated: 2026-07-03T08:35:59Z published: 2026-07-03T08:35:59Z canonical: "docs.document360.com/import-a-documentation-project" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Importar arquivo ZIP do projeto O recurso **Importar projeto** no Document360 permite que você traga um arquivo ZIP previamente exportado para qualquer projeto, restaurando ou migrando seus artigos, páginas de categoria e arquivos de mídia em uma única etapa. Isso é útil ao mover conteúdo entre projetos ou recuperar de um backup. O processo de importação valida o arquivo ZIP antes de aplicar qualquer alteração, então você pode revisar o que será adicionado antes de fazer o commit. --- ## Quando usar o recurso de importação de projeto Use esse recurso quando precisar: - **Migre conteúdo** — transfira artigos e categorias de um projeto Document360 para outro. - **Restaure a partir de um backup** — reimporte um arquivo ZIP previamente exportado para recuperar o conteúdo que foi perdido ou sobrescrevido. - **Consolide espaços de trabalho** — mesture conteúdo de um projeto exportado em um espaço de trabalho existente que compartilhe o mesmo slug. --- ## Antes de começar - Você deve ter a função **de conteúdo Editor** para importar um projeto. - Para funções de conteúdo personalizadas, sua conta deve ter acesso **Atualizar** e **Publicar** ao recurso **de Importação & Exportação do Projeto** . - O arquivo ZIP deve ser uma exportação de projeto Document360. Arquivos ZIP de outras plataformas não são suportados. - O tamanho máximo suportado de arquivo ZIP é **de 1 GB**. - Se o arquivo ZIP contiver idiomas que não estejam presentes no workspace de destino, adicione esses idiomas ao workspace de destino antes de importar. --- ## Como importar um arquivo ZIP de projeto 1. Passe o mouse sobre **as ferramentas de conteúdo** na barra de navegação da esquerda. 2. No submenu, navegue até **Importar e exportar** > **Importar e exportar projeto**. 3. Clique no **botão Importar** . O painel **de Importar projeto** se abre. 4. Arraste e solte o arquivo ZIP do seu projeto no painel, ou clique **em Upload** para selecionar o arquivo do seu armazenamento local. O Document360 faz upload e valida o arquivo ZIP automaticamente. 5. Se precisar usar outro arquivo, clique **em Substituir**. 6. Após validação bem-sucedida, revise a mensagem de confirmação, que exibe: - **Idiomas** incluídos no arquivo ZIP - **Número de categorias** - **Número de artigos** 7. Selecione a **opção Definir status de artigo para publicar** se quiser que todos os artigos importados sejam publicados imediatamente. Se não for selecionado, todos os artigos importados ficam configurados como **Rascunho**. 8. Clique **em Importar** para finalizar o processo. Todos os artigos e arquivos de mídia do arquivo ZIP agora estão disponíveis no projeto de destino. ![Import project panel in Document360 showing the upload area and validation confirmation](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/import%20&%20export.png) --- ### Importando projetos com o mesmo slug de workspace Quando o slug do workspace no arquivo ZIP corresponde ao slug do workspace do projeto de destino, os artigos e categorias **importados se fundem** com o conteúdo existente naquele workspace. ![Diagram showing content merging when workspace slugs match during import](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1767947695639.png) --- ### Importando para um projeto com um slug de workspace diferente Quando o slug do workspace no arquivo ZIP difere do slug do projeto de destino, o Document360 cria um **novo workspace** usando o nome e o slug do projeto importado. Todo o conteúdo importado é adicionado a esse novo espaço de trabalho. ![Diagram showing a new workspace being created when workspace slugs differ during import](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1767947720404.png) --- ### Importar um arquivo ZIP para um espaço de trabalho específico sem sobrescrever conteúdo existente Para importar conteúdo em um espaço de trabalho específico evitando conflitos com artigos existentes ou incompatibilidades entre slugs, edite manualmente o arquivo ZIP antes de importá-lo. 1. Exporte as categorias desejadas do seu projeto Document360 de origem como um arquivo ZIP. 2. Extraia o arquivo ZIP da sua máquina local. A pasta extraída contém dois diretórios: - **Mídia** — todos os arquivos de mídia do projeto. - **workspace_slug** — contém uma pasta **Artigos** , uma **pasta Categorias** e um `workspace_slug_category_articles` arquivo JSON. 3. Abra o `workspace_slug_category_articles` arquivo em um editor de código. 4. Atualize o nome do workspace e o slug para corresponder ao workspace de destino. 5. Salve o arquivo e renomeie usando o formato de slug do workspace de destino: `workspace_slug_category_articles`. **Exemplo:** `v2_category_articles` 6. Se necessário, atualize os slugs de artigos ou categorias individuais e ajuste o código do idioma nas pastas extraídas. 7. Comprima todos os arquivos modificados em um novo arquivo ZIP nomeado em referência ao slug do workspace de destino. 8. Retorne ao seu projeto Document360 e importe o arquivo ZIP recém-criado seguindo as [etapas padrão de importação](/docs/pt/import-a-documentation-project#how-to-import-a-project-zip-file). ![Screen recording showing how to update the workspace slug from v1 to v2 in extracted ZIP files, then re-import into Document360](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/4_ScreenGIF-Importing_steps_of_Document360_project.gif) A gravação de tela acima demonstra como mudar o slug e o nome do workspace de **v1** para **v2** nos arquivos extraídos, recomprimi-los e importar o ZIP atualizado para o projeto **v2** . --- ### Razões comuns de falência de importação Se sua importação falhar, verifique o seguinte: | Motivo | Resolução | | --- | --- | | **Recursos não suportados** | O ZIP contém espaços de trabalho, idiomas ou recursos que não estão disponíveis no seu plano atual. Passe o mouse sobre o ícone de informações para mais detalhes. | | **Nomes de slugs ou espaços de trabalho incompatíveis** | Certifique-se de que o nome do workspace e o slug no arquivo ZIP correspondam ao projeto de destino antes de fazer o upload. | | **Formato de arquivo incorreto** | Verifique se o ZIP segue a estrutura de exportação exigida do Document360. | | **Línguas faltantes no destino** | Adicione os idiomas necessários ao workspace de destino antes de importar. | | **Limite de espaço de trabalho atingido** | Se os slugs forem diferentes, o Document360 tenta criar um novo espaço de trabalho. Se o projeto já atingiu o limite de espaço de trabalho, exclua um espaço de trabalho não utilizado ou atualize o arquivo ZIP para que ele corresponda a um espaço de trabalho existente. | ![Document360 import failure screen showing error details and the info icon for unsupported features](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1767947754475.png) --- ## Melhores práticas - **Valide slugs de workspace antes de fazer upload** — slugs descompatíveis criam silenciosamente um novo workspace em vez de mesclar conteúdo. Confirme que os slugs de origem e destino coincidem antes de começar. - **Recrie conteúdo e reutilize elementos imediatamente após a importação** — modelos, variáveis, trechos e termos do glossário são excluídos do ZIP. Recrie-os imediatamente no projeto de destino para evitar referências quebradas em artigos recém-importados. - **Teste com uma única categoria primeiro** — para projetos grandes, exporte e importe uma categoria antes de executar a importação completa. Isso confirma que a configuração do slug e o mapeamento do espaço de trabalho estão corretos antes de se comprometer com uma operação em massa. --- ## FAQ   **O que acontece com meu conteúdo existente quando importo um arquivo ZIP de projeto Document360?**               O resultado depende se as lesmas do workspace coincidem. Se os slugs coincidirem, artigos e categorias importados se fundem com o conteúdo existente naquele espaço de trabalho. Se os slugs diferem, um novo espaço de trabalho é criado para o conteúdo importado. Importar não afeta as configurações do seu projeto, e os artigos que não estão presentes no arquivo ZIP permanecem inalterados.           **Templates, variáveis, trechos e glossário são incluídos ao importar um projeto?**               Não. Elementos de reutilização de conteúdo — modelos, variáveis, trechos e termos do glossário — não são exportados nem importados. Apenas artigos e arquivos de mídia são incluídos. Você deve recriar esses elementos manualmente no projeto de destino.           **O que acontece se eu importar um arquivo ZIP para o mesmo projeto de onde foi exportado?**               Quaisquer artigos no arquivo ZIP que correspondam a artigos existentes no projeto serão sobrescritos pela versão do ZIP. Artigos que existem no projeto, mas não estão no arquivo ZIP, permanecem inalterados.           **Como faço para encontrar o slug do workspace para o meu projeto?**               1. Navegue até **Configurações** () na barra de navegação da esquerda do portal da Base de Conhecimento. 2. No painel de navegação à esquerda, vá ao **portal da Base de Conhecimento** > **Localização & Espaços de Trabalho**. 3. Passe o mouse sobre o espaço de trabalho desejado e clique no **ícone Editar** (). 4. No painel **Editar espaço de trabalho** , localize o slug no campo **URL do Slug** .           **Posso importar arquivos ZIP de outras plataformas para o Document360?**               Não. Apenas arquivos ZIP gerados pelo recurso de exportação de projetos do Document360 são suportados. Arquivos ZIP de outras plataformas de base de conhecimento não podem ser importados.           **Qual é o tamanho máximo de arquivo ZIP que posso enviar?**               O Document360 suporta upload de arquivos ZIP de projeto até um tamanho máximo de 1 GB. ## Related - [Documentação offline](/export-documentation-as-zip.md)