O tema não sobe: o limite de upload do WordPress e como contornar

Se o envio do tema volta em branco, trava na barra de progresso ou avisa que o arquivo excede o tamanho máximo, o problema não é o tema: é o limite de upload que a sua hospedagem entregou. E existe um contorno que funciona em qualquer servidor, sem mexer em configuração nenhuma — ele está no fim deste texto.

Descubra o seu limite

Vá em Mídia > Adicionar nova. Abaixo da caixa de envio, o WordPress escreve o tamanho máximo. Se disser 8 MB ou 16 MB e o seu tema tem 60 MB, está explicado.

Um segundo lugar com mais detalhe: Ferramentas > Saúde do site > Informações > Servidor. Ali aparecem upload_max_filesize, post_max_size e memory_limit, que é o conjunto que decide.

O jeito definitivo: aumentar os limites

Três arquivos podem fazer isso, e qual funciona depende da hospedagem. Tente na ordem.

1. .user.ini, na raiz do WordPress (funciona na maioria das hospedagens com PHP-FPM):

• upload_max_filesize = 100M
• post_max_size = 100M
• memory_limit = 300M
• max_execution_time = 300
• max_input_vars = 5000

2. .htaccess, na raiz do WordPress, se o servidor for Apache — as mesmas diretivas com php_value na frente:

• php_value upload_max_filesize 100M
• php_value post_max_size 100M
• php_value memory_limit 300M
• php_value max_execution_time 300

Se o servidor for nginx, o .htaccess é simplesmente ignorado — nenhum erro aparece, nada muda, e é fácil perder tempo achando que a linha está errada.

3. php.ini, quando a hospedagem dá acesso a ele, com as mesmas diretivas do primeiro item. Depois de alterar, reinicie o PHP ou espere alguns minutos.

Muitos painéis (cPanel, Plesk, hPanel) têm uma tela de «Selecionar versão do PHP» ou «Configurações do PHP» que muda esses valores sem arquivo nenhum. Se existir, é o caminho mais curto.

O contorno que sempre funciona: FTP

O limite de upload é do formulário do WordPress. Enviar por FTP não passa por ele.

• Extraia o ZIP de instalação no seu computador. Você vai ficar com uma pasta.
• Conecte por FTP ou pelo gerenciador de arquivos da hospedagem.
• Envie a pasta para wp-content/themes/, se for tema, ou wp-content/plugins/, se for plugin.
• No painel, o item aparece na lista pronto para ativar.

É mais rápido do que parece e não depende de convencer o servidor de nada. Para um tema grande, costuma ser o primeiro caminho, não o último.

Se o limite não é o problema

Quando a mensagem fala em pacote inválido ou folha de estilos ausente, o tamanho não tem nada a ver: você está enviando o arquivo errado de dentro do pacote. Veja Stylesheet is missing.