Cara Mengatasi WordPress Tidak Bisa Upload Gambar: 7 Penyebab dan Solusinya

Bayangkan begini: Anda baru memotret produk terbaru untuk toko online, atau sudah menulis artikel panjang untuk website usaha Anda. Tinggal satu langkah lagi, yaitu mengunggah foto ke WordPress. Lalu tiba-tiba muncul pesan galat dan gambar gagal diunggah, padahal koneksi internet baik-baik saja dan file-nya terlihat normal.

Kabar baiknya, masalah WordPress tidak bisa upload gambar hampir selalu bisa diatasi sendiri, tanpa harus memanggil jasa developer. Penyebabnya memang bermacam-macam, mulai dari hal sepele seperti ukuran file yang terlalu besar sampai pengaturan di sisi hosting. Periksa dari yang paling mudah dulu, satu per satu, sampai ketemu sumber masalahnya. Berikut tujuh penyebab yang paling sering terjadi, lengkap dengan solusinya.

1. Ukuran File Melebihi Batas Upload

Ini penyebab nomor satu, dan juga yang paling gampang diperiksa. Setiap website WordPress punya batas maksimal ukuran file yang boleh diunggah, biasanya 2 MB, 8 MB, atau 32 MB, tergantung pengaturan hosting Anda. Kalau foto Anda berukuran 6 MB sementara batasnya hanya 2 MB, WordPress akan menolaknya begitu saja.

Untuk memeriksanya, masuk ke dashboard WordPress, lalu klik Media > Add New. Di bagian bawah halaman itu tertulis jelas batas maksimalnya, misalnya Maximum upload file size: 2 MB. Kalau file Anda lebih besar, kompres dulu sampai ukurannya di bawah batas, lalu coba unggah lagi. Kalau ingin menaikkan batasnya, buka MultiPHP INI Editor di cPanel dan ubah nilai upload_max_filesize serta post_max_size menjadi misalnya 64M. Pastikan nilai post_max_size sama atau lebih besar dari upload_max_filesize, karena kalau tidak, unggahan tetap gagal.

2. Format File Tidak Didukung atau File Rusak

WordPress secara bawaan hanya menerima format gambar yang umum, yaitu JPG, PNG, GIF, dan WebP. Kalau Anda mencoba mengunggah file berformat lain, misalnya TIFF, BMP, atau HEIC dari iPhone, WordPress akan menolaknya dan menampilkan pesan bahwa jenis file tersebut tidak diizinkan.

Solusinya sederhana: ubah dulu format file-nya menjadi JPG atau PNG sebelum diunggah, memakai aplikasi edit foto di ponsel atau komputer, atau konverter online gratis. Selain format, file yang rusak juga bisa jadi biang masalah, misalnya karena unduhan yang tidak selesai. Tandanya, file itu juga tidak bisa dibuka di komputer atau ponsel Anda. Kalau begitu, ambil ulang file aslinya dari kamera atau sumbernya.

3. Nama File Mengandung Karakter Aneh atau Spasi

Penyebab ini sering luput dari perhatian karena terlihat sepele, padahal cukup sering terjadi. Nama file seperti Foto Produk Baru (1) @Promo!.jpg mengandung spasi, tanda kurung, simbol @, dan tanda seru. Server dan WordPress tidak selalu bisa memproses karakter-karakter seperti itu dengan benar, sehingga unggahan pun gagal.

Gejalanya khas: file dengan ukuran kecil dan format yang benar tetap gagal diunggah, sementara file lain yang namanya sederhana berhasil. Kalau Anda curiga ini penyebabnya, ganti nama file-nya dulu sebelum mengunggah. Gunakan huruf kecil semua, tanpa spasi, dan pisahkan kata dengan tanda strip, misalnya foto-produk-baru-promo.jpg.

4. Folder wp-content/uploads Tidak Bisa Ditulis

Semua gambar yang Anda unggah disimpan di dalam folder wp-content/uploads di hosting. Kalau folder ini tidak bisa ditulis oleh server, WordPress tidak punya tempat untuk menyimpan gambar Anda, sehingga unggahan pasti gagal. Pesan galat yang muncul biasanya berbunyi Unable to create directory wp-content/uploads/2026/11. Is its parent directory writable by the server?

Masalah ini berhubungan dengan permission, yaitu izin akses pada folder dan file di server. Nilai yang benar untuk folder adalah 755, sedangkan untuk file adalah 644. Untuk memeriksanya, buka File Manager di cPanel, masuk ke folder wp-content, lalu klik kanan pada folder uploads dan pilih Change Permissions. Pastikan nilainya 755, dan terapkan ke semua subfolder di dalamnya. Jangan pernah memakai nilai 777, karena itu berarti siapa pun bisa menulis ke folder tersebut, dan itu berbahaya dari sisi keamanan.

5. Kehabisan Kuota Disk Hosting

Penyebab kelima ini sering tidak disadari, terutama oleh pemilik website yang sudah lama berjalan. Hosting punya batas ruang penyimpanan, dan setiap gambar, video, cadangan, serta email yang tersimpan di dalamnya memakan ruang itu. Kalau kuotanya sudah penuh, server tidak bisa lagi menerima file baru, sehingga unggahan gambar pun gagal.

Gejalanya cukup mudah dikenali: semua jenis file gagal diunggah, bukan cuma satu gambar tertentu, dan biasanya website juga mulai terasa lambat. Untuk memastikan, cek sisa kuota di dashboard hosting Anda. Di cPanel, informasi ini biasanya tampil di panel sebelah kanan dengan label Disk Usage. Kalau angkanya sudah mendekati 100 persen, hapus file yang sudah tidak terpakai, misalnya gambar duplikat di Media Library atau file cadangan lama. Kalau website Anda memang sudah berkembang, naikkan paket hosting ke yang kuotanya lebih besar.

6. Muncul Pesan “HTTP Error” Saat Upload

Pesan HTTP error adalah pesan yang paling membingungkan, karena tidak menjelaskan apa-apa. WordPress hanya bilang ada yang salah, tanpa menyebut penyebabnya. Padahal, di balik pesan singkat itu ada beberapa kemungkinan: memori PHP yang kurang, proses pembuatan thumbnail yang gagal, atau aturan keamanan server yang memblokir unggahan.

Langkah pertama, muat ulang halaman, lalu unggah lagi gambar yang sama. Kadang galat ini hanya gangguan sesaat karena server sedang sibuk. Kalau masih gagal, coba unggah gambar yang ukurannya lebih kecil, karena gambar beresolusi sangat besar butuh memori lebih banyak untuk diproses menjadi beberapa ukuran thumbnail. Kalau cara itu belum berhasil, naikkan batas memori PHP: buka file wp-config.php lewat File Manager, lalu tambahkan baris define( 'WP_MEMORY_LIMIT', '256M' ); tepat di atas baris yang bertuliskan That’s all, stop editing!. Kemungkinan lain adalah aturan mod_security di server yang terlalu ketat. Untuk yang satu ini, hubungi tim support hosting dan minta mereka memeriksa log-nya.

7. Konflik Plugin atau Tema

Penyebab terakhir yang juga cukup sering terjadi adalah konflik plugin atau tema. Plugin yang berhubungan langsung dengan gambar, seperti plugin kompresi gambar, plugin keamanan, atau plugin galeri, bisa ikut campur dalam proses unggah dan tanpa sengaja menggagalkannya. Biasanya masalah ini muncul setelah Anda memasang atau memperbarui plugin tertentu.

Cara mengujinya cukup mudah, tapi butuh sedikit kesabaran. Masuk ke Plugins > Installed Plugins, lalu nonaktifkan semua plugin untuk sementara dan coba unggah satu gambar kecil. Kalau unggahannya berhasil, berarti salah satu plugin memang penyebabnya. Aktifkan kembali plugin-plugin itu satu per satu, sambil menguji unggahan setiap kali selesai mengaktifkan satu plugin. Plugin terakhir yang Anda aktifkan sebelum unggahan kembali gagal, itulah biang masalahnya. Kalau semua plugin sudah dinonaktifkan tapi unggahan tetap gagal, coba ganti tema sementara ke tema bawaan WordPress, misalnya Twenty Twenty-Five. Jangan lupa mengaktifkan kembali plugin dan tema semula setelah selesai menguji.

Tips Pencegahan Supaya Gambar Selalu Berhasil Diunggah

Setelah ketujuh penyebab di atas teratasi, biasakan beberapa kebiasaan sederhana supaya masalah yang sama tidak terulang. Pertama, kompres gambar sebelum mengunggahnya. Foto langsung dari kamera bisa berukuran beberapa MB, padahal untuk tampil di website, ukuran di bawah 200 KB biasanya sudah cukup.

Kedua, biasakan memakai format JPG untuk foto produk dan WebP untuk gambar website secara umum, karena keduanya ringan dan didukung penuh oleh WordPress. Ketiga, beri nama file yang rapi sejak awal, dengan huruf kecil dan tanda strip, tanpa spasi atau simbol aneh. Keempat, pantau kuota hosting secara berkala, terutama kalau Anda sering mengunggah foto produk baru. Terakhir, selalu buat cadangan website sebelum mengutak-atik file seperti wp-config.php atau permission folder. Dengan memeriksa penyebab dari yang paling mudah, hampir semua masalah upload gambar di WordPress bisa diselesaikan sendiri. Kalau semua langkah di atas sudah dicoba dan masih gagal, barulah saatnya menghubungi tim support hosting, karena kemungkinan masalahnya memang ada di sisi server.