Aumentar limite de upload do WordPress: passo a passo

Aprenda a aumentar o limite de upload do WordPress na VPS: ajuste o PHP e o Nginx, reinicie os serviços e confira o novo tamanho na biblioteca de mídia.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 6 min de leitura

Aumentar limite de upload do WordPress na VPS exige ajustar três valores: upload_max_filesize e post_max_size no PHP, e client_max_body_size no Nginx. Depois, recarregue o Nginx, reinicie o PHP-FPM e confira o número novo.

Este guia parte de uma VPS Ubuntu com Nginx e PHP-FPM, como no guia Instalar WordPress na VPS: passo a passo com Nginx. Os valores 64M e 72M são exemplos: use o tamanho que você precisa. O nome seudominio.com.br também é exemplo.

Onde ver o limite atual

O WordPress mostra o limite em Mídia > Adicionar nova, na linha "Tamanho máximo de upload do arquivo". Anote esse número antes de mexer nos arquivos. Ao final do guia você vai voltar a essa tela para conferir.

O limite não é do WordPress. Ele vem do PHP e, em uma VPS com Nginx, também do Nginx. É preciso ajustar os dois.

Por que o WordPress recusa o arquivo

Ao enviar uma imagem grande, um vídeo, ou um tema ou plugin em .zip, o envio pode ser recusado por um destes limites:

• upload_max_filesize: tamanho máximo de um arquivo enviado. O padrão do PHP é 2M.
• post_max_size: tamanho máximo dos dados postados, com padrão de 8M. Ele afeta o upload e deve ser maior que upload_max_filesize.
• client_max_body_size: limite do Nginx para o corpo do pedido, com padrão de 1m. Se o pedido passar disso, o Nginx devolve o erro 413 (Request Entity Too Large).

Segundo a documentação do Nginx, os navegadores não conseguem exibir o erro 413 corretamente. Por isso, o que aparece no WordPress pode ser só um erro genérico, como "Erro HTTP". Já quando o arquivo passa do upload_max_filesize, a mensagem do PHP diz que o arquivo enviado excede essa diretiva no php.ini.

Há ainda um detalhe do post_max_size: se o envio passar desse valor, o PHP descarta os dados e as variáveis $_POST e $_FILES ficam vazias. Os valores aceitam os sufixos K, M e G.

Passo 1: descobrir a versão do PHP

O caminho do arquivo de configuração tem a versão do PHP. Veja qual pasta existe:

ls /etc/php/

Neste guia, a versão é a 8.3. Se a sua for outra, troque o número nos comandos seguintes.

Passo 2: ajustar o php.ini do PHP-FPM

Edite o php.ini do FPM, que é o usado pelo site:

sudo nano /etc/php/8.3/fpm/php.ini

Procure e ajuste estas linhas. Os números são exemplos:

upload_max_filesize = 64M

post_max_size = 72M

Mantenha o post_max_size maior que o upload_max_filesize. Quanto ao memory_limit, o padrão é 128M e, segundo a documentação do PHP, de maneira geral ele deve ser maior que o post_max_size. Se o seu valor ficou abaixo disso, aumente também.

Passo 3: ajustar o limite no Nginx

Abra o arquivo do site e procure o bloco server:

sudo nano /etc/nginx/sites-available/seudominio.com.br

Acrescente a linha abaixo dentro do bloco, com valor igual ou maior que o post_max_size:

client_max_body_size 72m;

O Nginx aceita essa diretiva nos contextos http, server e location. Para ver como o arquivo do site é montado, consulte o guia Nginx proxy reverso: como configurar na sua VPS. Teste a sintaxe e, se estiver certa, recarregue o Nginx:

sudo nginx -t

sudo systemctl reload nginx

Quer montar o seu WordPress em um servidor seu? Os planos de VPS saem a partir de R$ 17,00/mês, no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Passo 4: reiniciar o PHP-FPM

As mudanças no php.ini entram quando o serviço reinicia:

sudo systemctl restart php8.3-fpm

Se o comando acusar erro, confira se o número da versão é o mesmo que apareceu em ls /etc/php/.

Passo 5: conferir o número novo

Volte a Mídia > Adicionar nova. O WordPress deve mostrar o novo valor em "Tamanho máximo de upload do arquivo". Se o número não for o esperado, confira o upload_max_filesize e o post_max_size. Se mesmo assim ele não mudou, veja se o php.ini editado foi mesmo o do FPM e se o serviço foi reiniciado.

Arquivos muito grandes e o tempo de envio

Arquivo grande leva mais tempo para subir. No PHP, o max_execution_time tem padrão de 30 segundos, e o max_input_time tem padrão -1, que significa usar o valor do max_execution_time. Um envio lento pode bater nesses tempos mesmo com o tamanho liberado. O Nginx também tem tempos próprios.

Se isso acontecer com o seu arquivo, aumente esses tempos aos poucos e teste de novo. Não existe um número que sirva de regra: depende do tamanho do arquivo e da velocidade da sua conexão.

Alternativa: configurar por site (pool do PHP-FPM)

Se a VPS hospeda mais de um site, é possível definir o limite no arquivo do pool do PHP-FPM, em vez de mudar o php.ini geral. Segundo a documentação do PHP, valores definidos assim com php_admin_value não podem ser sobrescritos por ini_set. No Ubuntu, o pool padrão fica em /etc/php/8.3/fpm/pool.d/www.conf:

php_admin_value[upload_max_filesize] = 64M

php_admin_value[post_max_size] = 72M

Depois, reinicie o PHP-FPM como no passo 4. Esta etapa é opcional.

Cuidados ao aumentar o limite

Um limite alto demais permite envios enormes. Aumente só o necessário para o seu caso. Se você já usou o .htaccess para isso em outro tipo de servidor, saiba que o Nginx não lê esse arquivo, então a regra não vale aqui.

Antes de mexer em arquivos do servidor, faça cópia do que for editar. E se você vai subir um banco de dados grande, o guia Importar banco de dados MySQL: passo a passo e erros comuns trata desse caso. Se o site parar de abrir depois de uma edição, volte à cópia e rode sudo nginx -t para achar o erro de digitação.

Vai publicar o site com endereço próprio? Registre o seu domínio na Eleven Host. Registrar domínio

Perguntas frequentes

Por que só mexer no php.ini não resolve?

Porque, em uma VPS com Nginx, o limite do Nginx (client_max_body_size, padrão 1m) também vale. Se o pedido passar dele, o Nginx devolve o erro 413.

O que significa o erro 413?

É o Request Entity Too Large: o pedido é maior que o limite do Nginx. A documentação avisa que os navegadores não conseguem exibir esse erro corretamente, então o WordPress pode mostrar só uma mensagem genérica.

Preciso mexer no memory_limit?

O padrão do PHP é 128M. Segundo a documentação, de maneira geral ele deve ser maior que o post_max_size. Se o seu valor já é maior, não precisa mudar.

Posso usar o .htaccess para aumentar o limite?

No Nginx, não. Ele não lê o .htaccess. Use o php.ini do FPM e o arquivo do site no Nginx, como neste guia.