# Como corrigir a importação de cursos que falha no Tutor LMS

No Tutor LMS importar curso falha quando o arquivo JSON é importado sem os addons correspondentes ativos, o upload estoura o limite do PHP, ou o recurso de Import/Export do Tutor LMS Pro não está disponível no site de destino.

## O que é importação de curso que falha no Tutor LMS?

No Tutor LMS importar curso é feito pelo recurso Import/Export do Tutor LMS Pro, que move cursos entre sites usando um arquivo no formato JSON. Você exporta os cursos de um site em Tutor LMS Pro, aba Tools, e importa esse mesmo arquivo .json no site de destino. A falha de importação acontece quando o arquivo é enviado mas o processo não conclui, ou conclui parcialmente: o curso aparece sem aulas, sem quizzes ou sem os recursos avançados que existiam na origem.

A documentação oficial da Themeum aponta dois pontos que quebram a importação com mais frequência. O primeiro é a dependência de addons: se os cursos exportados usam content drip, pré-requisitos, reuniões online ou outras funcionalidades avançadas, os addons correspondentes do Tutor LMS precisam estar ativos no site de destino antes de importar, senão esses dados não são restaurados. O segundo é o aviso de que importar um arquivo com configurações sobrescreve os ajustes atuais do Tutor LMS. Somado a limites de upload do PHP e à ausência da versão Pro, esses fatores explicam a maioria das importações que falham.

## Como identificar

- A importação fica processando e não chega à tela de confirmação com os totais importados, ou retorna sem mensagem de sucesso.
- O curso é importado mas aparece sem aulas, sem quizzes ou sem o content drip e os pré-requisitos que existiam no site de origem.
- Ao escolher o arquivo, surge um erro de upload do tipo 'The uploaded file exceeds the upload_max_filesize directive' ou 'Arquivo muito grande'.
- A aba Import/Export não aparece em Tutor LMS > Tools porque o site de destino está com a versão gratuita, sem o Tutor LMS Pro.
- O navegador atinge tempo limite (erro 504 ou tela em branco) durante a importação de um arquivo JSON grande com muitos cursos.

**Antes de começar:** Antes de importar, faça um backup completo do site de destino (arquivos e banco de dados) e, se possível, teste a importação em um ambiente de staging. A importação com a opção Settings marcada sobrescreve as configurações atuais do Tutor LMS e não tem desfazer.

## Como prevenir

- Antes de importar, replique no site de destino os mesmos addons do Tutor LMS ativos na origem, para que content drip, pré-requisitos e reuniões online sejam restaurados.
- Exporte e importe sempre pelo recurso nativo Import/Export do Tutor LMS Pro, sem editar o arquivo .json à mão, para preservar a estrutura esperada pelo importador.
- Para cursos grandes, garanta limites de PHP folgados (upload_max_filesize, post_max_size e max_execution_time) no servidor de destino antes de iniciar a importação.
- Deixe a opção Settings desmarcada no export quando quiser mover apenas os cursos, evitando sobrescrever as configurações do Tutor LMS no destino.
- Mantenha o Tutor LMS e o Tutor LMS Pro na mesma versão estável nos dois sites para reduzir diferenças de estrutura entre origem e destino.

Erros relacionados

- [Como corrigir o Course Builder que não carrega no Tutor LMS](https://full.services/wp-fixer/corrigir-course-builder-nao-carrega-tutor-lms/)
- [Como corrigir o progresso do aluno que não atualiza no Tutor LMS](https://full.services/wp-fixer/corrigir-progresso-aluno-tutor-lms/)
- [Como corrigir instrutores sem permissão para criar cursos no Tutor LMS](https://full.services/wp-fixer/corrigir-permissao-instrutor-criar-curso-tutor-lms/)

## Causa

- Os addons usados pelos cursos exportados (content drip, pré-requisitos, reuniões online) não estão ativados no site de destino antes da importação, então esses recursos não são restaurados no curso importado, conforme alerta a documentação oficial da Themeum.
- O arquivo JSON exportado ultrapassa o limite de upload do PHP (upload_max_filesize ou post_max_size), fazendo o envio do arquivo ser rejeitado antes da importação começar.
- O Tutor LMS Pro não está instalado e ativo no site de destino: o recurso Import/Export é exclusivo da versão Pro, então a aba some de Tutor LMS > Tools e não há como importar.
- A importação de um JSON com muitos cursos estoura o max_execution_time do PHP, e o processo é interrompido pelo servidor antes de concluir.
- O arquivo selecionado foi gerado por outra ferramenta ou editado manualmente e não é o JSON nativo do Import/Export do Tutor LMS, então o importador não reconhece a estrutura.
- A opção de incluir Settings veio marcada no export, e a importação sobrescreve as configurações do Tutor LMS no destino, deixando o ambiente inconsistente com o curso importado.

## Como resolver

1. Confirme o Tutor LMS Pro ativo no site de destino: O recurso Import/Export existe apenas no Tutor LMS Pro. Verifique se a versão Pro está instalada e ativa no site onde você vai importar, senão a aba Import/Export não aparece em Tutor LMS > Tools.

```
Painel WP -> Plugins -> Plugins Instalados
Confirme que 'Tutor LMS Pro' está ativo (além do Tutor LMS gratuito)
```

2. Ative os addons usados pelos cursos antes de importar: A documentação da Themeum orienta ativar, no site de destino, os addons correspondentes aos recursos dos cursos exportados (content drip, pré-requisitos, reuniões online) antes de importar. Sem eles, o curso importado vem sem esses recursos.

```
Painel WP -> Tutor LMS -> Add-ons
Ative os mesmos addons usados na origem (ex.: Content Drip, Prerequisites)
```

3. Use a aba Import/Export e selecione o arquivo .json correto: Vá para a aba Import/Export do Tutor LMS Pro e selecione o arquivo .json gerado pelo próprio recurso de exportação. Não use arquivos editados à mão ou de outras ferramentas, pois o importador espera a estrutura nativa do Tutor LMS.

```
Painel WP -> Tutor LMS Pro -> Tools -> aba Import/Export
Na seção Import, clique em 'Choose a File' e selecione o .json exportado
Clique em 'Import' e aguarde a tela de confirmação com os totais importados
```

4. Aumente os limites de upload e execução do PHP: Se o arquivo é grande e o envio é rejeitado ou a importação expira, aumente os limites do PHP. Você pode pedir ao suporte da hospedagem ou aplicar o trecho da seção de código em wp-config.php ou no php.ini do servidor.

```
Confira o limite atual em Painel WP -> Ferramentas -> Saúde do Site -> Informações -> Servidor
Aumente upload_max_filesize, post_max_size e max_execution_time (ver bloco de código)
```

5. Reimporte e valide o curso restaurado: Com os addons ativos e os limites ajustados, repita a importação e abra o curso no Course Builder para confirmar que aulas, quizzes e recursos avançados vieram completos. Se exportou com Settings marcado, revise as configurações do Tutor LMS, pois elas foram sobrescritas.

```
Painel WP -> Tutor LMS Pro -> Tools -> Import/Export -> Import (repita)
Painel WP -> Tutor LMS -> Cursos -> abra o curso importado e revise o conteúdo
Painel WP -> Tutor LMS -> Settings -> confira se as configurações continuam corretas
```


## Código

```ini
; php.ini ou .user.ini na raiz do site — aumenta os limites para
; importar arquivos JSON grandes de cursos do Tutor LMS sem estourar.
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
```

## Perguntas frequentes

### Qual o formato do arquivo de importação de cursos no Tutor LMS

O recurso Import/Export do Tutor LMS Pro usa o formato JSON. Você exporta os cursos em um arquivo .json e importa esse mesmo arquivo no site de destino, pela aba Import/Export em Tutor LMS Pro > Tools.

### Por que o curso importado veio sem content drip ou pré-requisitos

Porque os addons correspondentes não estavam ativos no destino na hora da importação. A documentação da Themeum orienta ativar os addons usados pelos cursos (content drip, pré-requisitos, reuniões online) antes de importar para que esses recursos sejam restaurados.

### Não encontro a aba Import Export no Tutor LMS, por quê

O recurso Import/Export é exclusivo do Tutor LMS Pro. Se o site só tem a versão gratuita, a aba não aparece em Tools. Instale e ative o Tutor LMS Pro no site de destino para liberar a importação de cursos.

### A importação trava em arquivos grandes, o que fazer

Arquivos grandes podem estourar os limites do PHP. Aumente upload_max_filesize, post_max_size e max_execution_time no servidor, ou peça à hospedagem. Depois repita a importação pela aba Import/Export.

### Importar um curso sobrescreve minhas configurações do Tutor LMS

Sobrescreve se o arquivo foi exportado com a opção Settings marcada. A documentação alerta que importar configurações substitui os ajustes atuais. Para mover só os cursos, exporte sem Settings; se já importou, revise as configurações depois.

### Posso importar um curso de um site para outro com domínios diferentes

Sim. O Import/Export foi feito para migrar cursos entre sites. Garanta apenas que o destino tenha o Tutor LMS Pro e os mesmos addons ativos, e que os limites de upload do servidor comportem o arquivo .json.

### Posso editar o arquivo JSON exportado antes de importar

Não é recomendado. O importador espera a estrutura nativa gerada pela exportação do Tutor LMS. Editar o JSON à mão pode corromper o arquivo e fazer a importação falhar ou trazer o curso incompleto.

### A importação do curso traz também os alunos matriculados

O Import/Export move a estrutura do curso (aulas, quizzes e recursos avançados, com os addons ativos), não as matrículas de alunos do site de origem. Os alunos precisam se matricular novamente no site de destino.

**Fonte:** [Themeum — How to Import Export Tutor LMS Courses](https://docs.themeum.com/tutor-lms/tutorials/import-export-tutor-lms-courses/)