Documentação para desenvolvedores: Solução de problemas
Referência
Solução de problemas
Soluções para os problemas mais comuns: nada acontece, o arquivo original continua chegando, uma ferramenta não aparece.
Nada acontece quando escolho um arquivo grande+
Confira se o script está na página: digite PDFkind.version no console do navegador, que deve mostrar 3. Depois confira se o atributo está no campo, na área de soltar, em um elemento pai ou no script (data-max), e se o arquivo realmente passa do limite (1 MB = 1.000.000 bytes).
A janela abre e o arquivo original chega depois de 8 segundos+
Provavelmente as regras de segurança do seu site bloqueiam frames do pdfkind.com. Adicione-o a frame-src: veja Content Security Policy. O console do navegador mostra uma mensagem quando isso acontece.
Meu código continua recebendo o arquivo grande+
Seu código lê os arquivos antes do evento change ou drop, ou a partir de outro elemento. Leia-os a partir do evento (e.target.files, e.dataTransfer.files) ou chame PDFkind.fit() você mesmo.
“Não foi possível deixar este arquivo abaixo de 5 MB”+
O arquivo é composto principalmente de digitalizações em altíssima resolução. Uma digitalização em resolução menor, ou dividir o arquivo, resolve. Seu formulário recebe o original e mostra o erro de sempre.
Uma ferramenta não aparece na minha single-page app+
O elemento foi adicionado depois que o script rodou. Chame PDFkind.mount() depois de renderizá-lo.
A ferramenta aparece cortada ou com barra de rolagem+
As ferramentas de edição mantêm a altura que você define: use data-height="820" ou mais. As outras ferramentas se ajustam sozinhas.
A janela está no idioma errado+
Defina data-lang no campo ou no script. Veja Idiomas.
Ainda com problemas? Escreva para contact@pdfkind.com informando o endereço da sua página.
Atualizado em 3 de novembro de 2026 · Dúvidas: contact@pdfkind.com