Penyebab Gagal Upload Gambar atau File di WordPress dan Cara Mengatasinya
Gagal upload gambar di WordPress biasanya ditandai pesan HTTP error, proses yang berhenti di tengah jalan, atau keterangan bahwa ukuran file melebihi batas. Penyebabnya bisa datang dari pengaturan server, konfigurasi WordPress, izin folder, hingga koneksi internet pengguna.
Artikel ini membahas penyebab gagal upload gambar di WordPress yang paling sering terjadi, cara melakukan pengecekan, dan solusinya.
- Bentuk Pesan Error Saat Upload di WordPress
- Penyebab Gagal Upload Gambar di WordPress dan Solusinya
- 1. Batas Ukuran Upload (upload_max_filesize) Terlampaui
- 2. Memori PHP atau Waktu Eksekusi Tidak Cukup
- 3. Izin Folder atau Kepemilikan File Salah
- 4. Batas max_input_vars Tercapai (Sering Dikira Masalah Upload)
- 5. Plugin, Tema, atau Firewall Menghalangi Upload
- 6. Format, Nama, atau Ukuran File Tidak Sesuai
- 7. Koneksi Internet Tidak Stabil Saat Proses Upload
- Tips Mencegah Gagal Upload Gambar di WordPress
- Kesimpulan
Bentuk Pesan Error Saat Upload di WordPress
Pesan error biasanya sudah menunjukkan arah penyebab dari masalah yang Anda alami. Berikut yang paling sering ditemukan, lengkap dengan bagian yang perlu Anda cek lebih dulu:
| Pesan error | Artinya | Cek bagian |
|---|---|---|
| HTTP error | Pesan umum yang bisa disebabkan memori PHP, batas waktu eksekusi, pemrosesan gambar di server, atau koneksi internet terputus. Pembahasan khususnya ada di artikel cara mengatasi HTTP error saat upload gambar di WordPress. | 2, 7 |
| The uploaded file exceeds the upload_max_filesize directive in php.ini | Ukuran file melebihi batas upload PHP. | 1 |
| Request Entity Too Large (kode 413) | Ukuran permintaan melebihi batas yang diizinkan server web, umumnya pada Nginx atau konfigurasi hosting tertentu. | 1 |
| Unable to create directory wp-content/uploads/… | Masalah izin folder atau ruang penyimpanan penuh. | 3 |
| Sorry, you are not allowed to upload this file type | Format file tidak diizinkan oleh WordPress. | 6 |
| Upload berhenti di tengah tanpa pesan yang jelas | Kemungkinan terkait koneksi internet atau batas waktu. | 7, 2 |
Penyebab Gagal Upload Gambar di WordPress dan Solusinya
1. Batas Ukuran Upload (upload_max_filesize) Terlampaui
WordPress tidak menetapkan batas ukuran file sendiri pada instalasi biasa. Batasnya ditentukan PHP melalui upload_max_filesize dan post_max_size, dan yang berlaku adalah nilai yang paling kecil di antara keduanya. Hubungan kedua pengaturan ini juga dijelaskan di dokumentasi PHP tentang file upload.
Nilai bawaan PHP hanya 2 MB untuk upload_max_filesize dan 8 MB untuk post_max_size, sedangkan sebagian hosting menetapkan nilai yang berbeda.
Cara memeriksa
Buka Media > Add New, batas ukuran file ditampilkan di halaman tersebut. Nilai lengkapnya juga ada di Tools > Site Health > Info > Server.
SolusiNaikkan kedua nilai tersebut lewat salah satu cara berikut, tergantung pengaturan hosting.
php.ini atau .user.ini
upload_max_filesize = 64M post_max_size = 64M.htaccess (Apache dengan mod_php)
php_value upload_max_filesize 64M php_value post_max_size 64MJika hosting memakai Nginx dan muncul kode 413, tambahkan juga baris berikut pada konfigurasi server:
client_max_body_size 64M;Sebagian hosting menyediakan pengaturan ini di panel kontrol (misalnya menu PHP Settings atau MultiPHP INI Editor), dan cara itu biasanya paling aman. Pada WordPress Multisite, periksa juga batas upload di pengaturan jaringan.
2. Memori PHP atau Waktu Eksekusi Tidak Cukup
Saat gambar di-upload, WordPress membuat beberapa ukuran turunan seperti thumbnail, medium, dan large. Foto beresolusi tinggi dari kamera atau ponsel membutuhkan memori yang besar untuk diproses. Jika memori habis atau prosesnya melewati batas waktu, hasilnya seringkali berupa HTTP error.
Solusi
- Tambahkan baris berikut di
wp-config.php, sebelum tulisan That’s all, stop editing!:define( 'WP_MEMORY_LIMIT', '256M' ); - Naikkan
memory_limitdanmax_execution_timediphp.iniatau.user.ini:memory_limit = 256M max_execution_time = 300 - Perkecil resolusi gambar sebelum di-upload.
Jika error tetap munculPada gambar tertentu, sebagian server bermasalah dengan pustaka Imagick. Solusinya, beralih ke editor gambar GD. Tambahkan kode berikut di functions.php tema anak atau lewat plugin penyimpan potongan kode:
add_filter( 'wp_image_editors', function() { return array( 'WP_Image_Editor_GD' ); } );3. Izin Folder atau Kepemilikan File Salah
WordPress perlu hak tulis pada folder wp-content/uploads. Jika izinnya salah, atau folder dimiliki pengguna server yang berbeda (misalnya setelah proses pemindahan hosting), WordPress tidak bisa menyimpan file dan menampilkan pesan Unable to create directory.
Solusi
- Lewat FTP atau file manager, atur izin folder menjadi 755 dan file menjadi 644 pada
wp-content/uploadsbeserta isinya. - Pastikan kepemilikan folder sesuai dengan pengguna akun hosting. Jika tidak yakin, minta bantuan penyedia hosting.
- Periksa kuota penyimpanan akun hosting. Ruang disk yang penuh juga memunculkan pesan yang sama.
4. Batas max_input_vars Tercapai (Sering Dikira Masalah Upload)
Catatan
Pengaturan ini tidak membatasi ukuran file.max_input_vars membatasi jumlah variabel atau field formulir yang diterima PHP dalam satu permintaan, dengan nilai bawaan 1.000.
Dampaknya terlihat saat menyimpan menu navigasi yang besar, pengaturan tema, atau halaman dengan banyak elemen dari page builder. Sebagian data tidak tersimpan dan tidak selalu ada pesan error yang jelas. Periksa penyebab ini bila file berhasil di-upload tetapi menu atau pengaturan setelahnya tidak tersimpan dengan lengkap.
SolusiNaikkan nilainya di php.ini atau .user.ini:
max_input_vars = 3000Baca Juga
5. Plugin, Tema, atau Firewall Menghalangi Upload
Plugin keamanan, plugin optimasi gambar, atau tema tertentu dapat berkonflik dengan proses upload. Firewall di sisi hosting, seperti ModSecurity, juga bisa memblokir permintaan yang dianggap mencurigakan dan menghasilkan kode 403 atau 406.
Cara cek
- Nonaktifkan semua plugin, lalu coba upload lagi.
- Jika berhasil, aktifkan plugin satu per satu sampai error muncul kembali.
- Coba beralih sementara ke tema bawaan WordPress.
- Coba dari browser lain atau mode incognito untuk menyingkirkan masalah cache atau ekstensi browser.
Jika kode 403 atau 406 tetap muncul tanpa ada plugin yang bermasalah, minta penyedia hosting memeriksa log firewall server.
6. Format, Nama, atau Ukuran File Tidak Sesuai
WordPress membatasi tipe file yang boleh di-upload demi keamanan. Format seperti SVG tidak diizinkan secara bawaan, dan nama file yang mengandung spasi atau karakter khusus juga kadang menimbulkan masalah.
Selain itu, sejak WordPress 5.3, gambar yang sisi terpanjangnya melebihi 2560 piksel akan diperkecil otomatis, dan prosesnya tetap memakan memori.
Solusi
- Ganti nama file dengan huruf, angka, dan tanda hubung.
- Kompres dan perkecil gambar sebelum di-upload.
- Ubah format ke JPG, PNG, atau WebP untuk gambar yang akan ditampilkan di halaman.
- Untuk SVG atau format lain yang memang dibutuhkan, gunakan plugin yang menyediakan pengaturan keamanannya, bukan mengubah pembatasan secara sembarangan.
7. Koneksi Internet Tidak Stabil Saat Proses Upload
Upload bergantung pada kecepatan unggah dan kestabilan koneksi internet sampai seluruh file diterima server. Koneksi yang terputus sebentar saja sudah cukup untuk menggagalkan prosesnya, dan WordPress menampilkan HTTP error meskipun pengaturan server sudah benar.
Sebagian paket WiFi rumah memiliki kecepatan unggah yang jauh lebih kecil daripada kecepatan unduh, sehingga upload file besar lebih lama dan lebih rentan gagal.
Tanda-tanda masalah ada di koneksi internet:
- Error muncul acak. File yang sama kadang berhasil, kadang gagal.
- Proses berhenti di tengah, sementara file kecil tetap lancar.
- Masalah lebih sering terjadi saat sinyal WiFi lemah atau banyak perangkat memakai jaringan.
Cara cek
- Lakukan speed test dan perhatikan angka upload, bukan hanya download.
- Coba upload file yang sama dari jaringan lain, misalnya hotspot ponsel. Jika berhasil, penyebabnya kemungkinan ada di jaringan awal.
- Coba upload file berukuran kecil sebagai pembanding.
Solusi
- Gunakan kabel LAN atau dekatkan perangkat ke router.
- Kurangi perangkat lain yang sedang memakai bandwidth, seperti streaming atau download besar.
- Kompres file sebelum di-upload.
- Untuk file yang sangat besar, gunakan FTP atau SFTP yang prosesnya bisa dilanjutkan bila terputus.
- Gunakan layanan internet yang stabil dengan kecepatan unggah memadai.
Bagi Anda yang sering mengelola website dari rumah, pastikan layanan internet yang digunakan memadai untuk mendukung aktivitas tersebut, baik pada siang maupun malam hari. WiFi fiber optik Megavision mengandalkan jaringan 100% fiber optik dengan kecepatan simetris 1:1, sehingga kecepatan upload sama dengan download.
Layanan ini juga tanpa FUP, jadi tidak perlu khawatir kehabisan kuota setelah menggunakan data dalam jumlah besar seharian.
Tips Mencegah Gagal Upload Gambar di WordPress
Sudah menemukan penyebab dan solusi yang tepat? Pastikan gangguan tidak terjadi lagi di kemudian hari. Lakukan beberapa hal berikut agar aktivitas blogging atau kelola website di WordPress tetap lancar:
- ✓Kompres dan perkecil gambar sebelum di-upload. Lebar 1600 sampai 2000 piksel umumnya sudah cukup untuk gambar artikel.
- ✓Pilih hosting dengan batas PHP yang memadai, misalnya
memory_limit256 MB dan batas upload minimal 64 MB. - ✓Gunakan FTP atau SFTP untuk file yang sangat besar.
- ✓Lakukan upload file besar menggunakan jaringan internet yang stabil.
- ✓Buat backup sebelum mengubah file konfigurasi seperti
wp-config.php,.htaccess, atauphp.ini.
Kesimpulan
Gagal upload di WordPress bisa disebabkan oleh berbagai hal, seperti batas ukuran upload, memori PHP, izin folder, plugin atau firewall, format file, hingga koneksi internet. Mulailah dari pesan error yang muncul, karena biasanya itu petunjuk tercepat menuju penyebabnya.
Tidak hanya untuk mengelola website di WordPress, koneksi internet yang cepat dan stabil juga bermanfaat untuk mendukung berbagai aktivitas digital lainnya melalui satu jaringan saja. Cek info WiFi murah dari Megavision di website resmi megavision.net.id.
Last Updated on November 19, 2026 by Taufiq Prasetya Pradana