Home » Cara Mengatasi Gambar di WordPress Tidak Muncul: 7 Penyebab dan Solusinya
Cara Mengatasi Gambar di WordPress Tidak Muncul: 7 Penyebab dan Solusinya
Foto produk sudah di-upload ke Media Library dan terlihat rapi di dashboard. Tapi begitu halamannya dibuka, yang muncul justru ikon gambar rusak, kotak kosong, atau hanya teks alternatifnya.
Penting untuk diluruskan dulu: artikel ini membahas gambar yang sudah berhasil di-upload, tapi tidak tampil di halaman atau postingan. Ini berbeda dengan gambar yang gagal di-upload sejak awal, misalnya muncul pesan "HTTP error" saat proses upload. Di sini gambarnya sudah ada di server, hanya saja browser tidak bisa menampilkannya. Jadi solusinya bukan meng-upload ulang, melainkan mencari di mana rantai antara file dan browser itu putus. Kabar baiknya, sebagian besar kasus berasal dari tujuh penyebab yang sama, dan Anda tidak perlu bisa coding untuk memperbaikinya.
Diagnosis Cepat Sebelum Memperbaiki
Klik kanan pada gambar yang rusak, pilih Open image in new tab atau Copy image address, lalu tempel alamatnya di tab baru. Kalau gambar terbuka normal, filenya baik-baik saja — masalahnya ada di halaman, tema, atau plugin. Kalau muncul 404 Not Found, alamat gambar salah atau filenya tidak ada di lokasi itu. Kalau muncul 403 Forbidden, server menolak memberikan file tersebut. Informasi kecil ini mempersempit pencarian Anda ke penyebab yang tepat. Periksa juga di Mode Incognito setelah perbaikan, supaya Anda melihat versi terbaru, bukan cache lama.
1. URL Gambar Masih Mengarah ke Domain Lama Setelah Migrasi
Ini penyebab paling umum. Anda pindah hosting, ganti domain, atau memindahkan website dari alamat staging seperti staging.tokosaya.com ke domain asli tokosaya.com. Website-nya pindah, tapi alamat gambar di dalam artikel masih menunjuk ke alamat lama. Hal serupa terjadi kalau alamat gambar masih http:// padahal website sudah https:// — browser memblokirnya.
Solusinya, perbarui alamat gambar di database dengan plugin Better Search Replace. Sebelum menjalankannya, backup dulu website Anda, karena perubahan database tidak bisa di-undo. Isi kolom Search dengan alamat lama dan kolom Replace dengan alamat baru, pilih semua tabel, lalu jalankan Dry Run dulu untuk melihat berapa banyak data yang akan berubah. Kalau angkanya masuk akal, jalankan penggantiannya, lalu bersihkan cache.
2. Pengaturan Permalink Berubah atau File .htaccess Rusak
WordPress memakai file .htaccess untuk mengatur bagaimana alamat website diterjemahkan oleh server. Kalau file ini rusak — misalnya setelah instalasi plugin keamanan atau migrasi — alamat gambar bisa ikut terseret dan tidak ditemukan server, meskipun filenya masih ada di folder uploads.
Perbaikannya sederhana. Masuk ke Settings → Permalinks, lalu klik Save Changes tanpa mengubah apa pun. Tindakan ini membuat WordPress menulis ulang aturan di .htaccess dengan format yang benar. Kalau masih rusak, periksa apakah file gambar benar-benar ada di server: buka File Manager di hosting, masuk ke folder wp-content/uploads, dan cari folder tahun dan bulan yang sesuai dengan tanggal upload gambar tersebut.
3. Izin File (File Permissions) di Folder Uploads Salah
Setiap file dan folder di server punya izin akses. Kalau izin folder uploads terlalu ketat, server tidak mengizinkan browser membaca file gambar di dalamnya, dan hasilnya adalah pesan 403 Forbidden.
Aturan umumnya: folder memakai izin 755 dan file memakai izin 644. Angka ini memberi server izin membaca yang cukup, tanpa membuka akses tulis yang berbahaya. Untuk memperbaikinya, buka File Manager di panel hosting (misalnya cPanel), klik kanan folder wp-content/uploads, pilih Change Permissions, atur ke 755, dan terapkan juga ke semua folder di dalamnya. Lakukan hal yang sama untuk file gambarnya dengan nilai 644.
4. Hotlink Protection atau Aturan Keamanan Hosting Memblokir Gambar Anda Sendiri
Hotlink protection mencegah website lain menampilkan gambar Anda dengan menautkan langsung ke file di server Anda. Fitur ini berguna untuk menghemat bandwidth, tapi kalau konfigurasinya keliru, ia bisa memblokir website Anda sendiri. Gambar tidak tampil, padahal file dan alamatnya benar.
Cek fitur ini di panel hosting Anda — di cPanel biasanya ada di menu Hotlink Protection. Kalau fitur ini aktif, pastikan domain Anda sendiri masuk dalam daftar yang diizinkan. Nonaktifkan sementara hotlink protection, lalu muat ulang halaman. Kalau gambar langsung muncul, Anda sudah menemukan biang masalahnya. Aktifkan lagi fitur tersebut dengan konfigurasi yang benar — domain sendiri harus selalu ada di daftar pengecualian.
5. Lazy Load, CDN, dan Plugin Optimasi Gambar Saling Bentrok
Plugin optimasi gambar membantu website lebih cepat: ia menunda pemuatan gambar sampai gambar itu terlihat di layar (lazy load), mengubah format gambar menjadi WebP, atau menyajikan gambar lewat CDN. Masalah muncul ketika dua plugin melakukan tugas yang sama sekaligus, atau ketika sebuah plugin menulis ulang alamat gambar ke alamat CDN yang sudah tidak aktif. Hasilnya, gambar tidak pernah dimuat dan halaman hanya menampilkan ruang kosong.
Untuk mendiagnosisnya, nonaktifkan sementara fitur lazy load di plugin optimasi Anda (misalnya LiteSpeed Cache atau WP Rocket), lalu muat ulang halaman. Kalau gambar kembali muncul, berarti fitur itulah penyebabnya. Untuk CDN, matikan sementara fitur "CDN URL rewriting" — alamat gambar mungkin masih menunjuk ke CDN lama yang sudah mati. Setelah itu, bersihkan cache plugin, server, dan CDN.
6. Nama File Berkarakter Khusus dan Thumbnail yang Belum Dibuat Ulang
Nama file gambar sering jadi penyebab yang luput dari perhatian. File bernama Foto Produk (Baru) & Promo 50%.jpg mengandung spasi, tanda kurung, simbol &, dan persen — karakter-karakter ini bisa membuat alamat gambar diterjemahkan secara salah oleh browser atau server.
Biasakan memberi nama file yang sederhana sebelum meng-upload: huruf kecil semua, kata dipisah tanda strip, tanpa spasi atau simbol, misalnya foto-produk-kopi-arabika.jpg. Untuk gambar yang sudah terlanjur di-upload dengan nama bermasalah, cara paling aman adalah meng-upload ulang dengan nama yang sudah diperbaiki, lalu mengganti gambar lama di halaman terkait. Masalah terkait: thumbnail. WordPress membuat beberapa ukuran turunan saat upload; kalau proses itu gagal, halaman yang memakai ukuran tertentu menampilkan gambar rusak. Perbaiki dengan plugin Regenerate Thumbnails dari menu Tools → Regenerate Thumbnails.
7. Konflik Plugin atau Tema
Kalau enam penyebab di atas sudah diperiksa dan gambar masih juga tidak muncul, kemungkinan besar ada plugin atau tema yang bentrok. Plugin galeri, plugin optimasi, atau tema yang mengubah cara gambar ditampilkan bisa saling bertabrakan — apalagi setelah salah satunya diperbarui.
Cara memeriksanya adalah dengan metode eliminasi. Nonaktifkan semua plugin, lalu periksa apakah gambar kembali tampil. Kalau ya, aktifkan plugin satu per satu sambil memeriksa gambar setiap kali, sampai Anda menemukan plugin yang membuat gambar rusak lagi. Kalau tidak membantu, ganti sementara ke tema bawaan seperti Twenty Twenty-Five dan periksa lagi. Kalau gambar muncul dengan tema bawaan, berarti tema Anda yang bermasalah — hubungi pengembang tema atau pertimbangkan beralih ke tema yang terawat. Setelah selesai menguji, kembalikan tema dan plugin seperti semula, kecuali plugin yang terbukti bermasalah.
Kesimpulan: Perbaiki Berurutan, Jangan Tebak-tebakan
Gambar WordPress yang tidak muncul hampir selalu punya penyebab yang bisa dilacak. Mulailah dari diagnosis cepat — buka alamat gambar di tab baru dan catat apakah yang muncul 404 atau 403. Lalu periksa berurutan: alamat gambar setelah migrasi, permalink dan .htaccess, izin file di folder uploads, hotlink protection, bentrok lazy load dan CDN, nama file dan thumbnail, dan terakhir konflik plugin atau tema.
Untuk toko online dan company profile, gambar adalah bagian dari kepercayaan. Karena itu, biasakan tiga hal: beri nama file yang bersih sebelum meng-upload, backup website sebelum menjalankan search-replace atau mengganti tema, dan periksa halaman penting Anda di Mode Incognito setelah setiap perubahan besar. Kalau masih belum tampil, hubungi dukungan hosting Anda dengan menyertakan alamat gambar dan kode statusnya (404 atau 403).