Cara Mengatasi WordPress Stylesheet Is Missing saat Install Tema - The Last Digital

Anda mengunduh tema WordPress baru, mengunggahnya lewat Appearance, lalu muncul pesan yang membuat frustrasi:

Daftar Isi

• Jawaban Singkat
• Kenapa WordPress Membutuhkan style.css?
• Persiapan
• Langkah 1: Bongkar Paket Unduhan dan Temukan File Tema yang Benar
• Langkah 2: Kompres Ulang Folder Tema dengan Benar
• Langkah 3: Unggah Ulang Lewat Dashboard
• Langkah 4: Bila Masih Gagal — Periksa Header style.css dan Child Theme
• Alternatif: Instalasi Lewat FTP atau File Manager
• Verifikasi Hasil
• Troubleshooting Lanjutan
• FAQ
• Kesimpulan
• Referensi

The package could not be installed. The theme is missing the style.css stylesheet.

Pesan ini tidak berarti tema itu rusak total. Artinya, WordPress tidak menemukan file style.css di tempat yang ia harapkan: di folder utama tema, di dalam arsip ZIP yang Anda unggah. Dalam sebagian besar kasus, file itu sebenarnya ada — hanya saja terbungkus satu lapisan terlalu dalam, atau Anda mengunggah paket yang salah dari unduhan pengembang. Kabar baiknya lagi, tema lama Anda tetap aktif dan tidak rusak oleh kegagalan instalasi ini.

Jawaban Singkat

Ekstrak file ZIP yang Anda unduh di komputer Anda, dan cari folder tema yang di dalamnya langsung terdapat style.css. Jika yang Anda temukan justru folder dokumentasi, file lisensi, dan satu ZIP lain di dalamnya, maka ZIP di dalam itulah file tema yang benar — unggah ZIP itu, bukan paket luarnya. Jika tidak ada ZIP kedua, kompres ulang folder tema itu sendiri (bukan folder induknya) menjadi ZIP baru, lalu unggah lewat Appearance, Themes, Add New, Upload Theme. Itu saja; sebagian besar kasus selesai di sini.

Kenapa WordPress Membutuhkan style.css?

Setiap tema WordPress wajib memiliki file style.css di folder utamanya. File ini bukan sekadar lembar gaya: baris komentar di bagian atasnya adalah kartu identitas tema — di sanalah WordPress membaca nama tema, versi, penulis, dan, untuk child theme, nama folder tema induknya. Tanpa file itu di tempat yang tepat, WordPress tidak bisa mengenali paket yang Anda unggah sebagai tema, sehingga instalasi ditolak sebelum dimulai. Inilah alasan pesan kesalahannya sangat spesifik: bukan "tema rusak", melainkan "stylesheet tidak ditemukan".

Struktur yang benar terlihat seperti ini ketika Anda membuka ZIP tema:

nama-tema/
├── style.css
├── index.php
├── functions.php
└── ... (folder dan file tema lainnya)

Jika yang Anda lihat pertama kali adalah folder dokumentasi, file PSD, atau folder lain yang di dalamnya baru ada folder tema, Anda sedang memegang paket unduhan lengkap dari pengembang, bukan file tema yang siap instal.

Persiapan

• Pastikan tema lama Anda masih aktif — kegagalan instalasi ini tidak mengubah tema yang sedang berjalan, jadi situs Anda tetap tampil seperti biasa selama proses perbaikan.
• Simpan salinan file unduhan asli dari pengembang sebelum mengekstrak dan mengompres ulang, supaya Anda tidak kehilangan paket lengkapnya (termasuk dokumentasi dan lisensi).
• Unduh ulang tema dari sumber tepercaya bila Anda ragu dengan keutuhan file: direktori tema WordPress.org atau akun resmi tempat Anda membeli tema tersebut. Tema dari sumber yang tidak jelas lebih berisiko kehilangan file atau berisi file yang bukan tema WordPress.

Langkah 1: Bongkar Paket Unduhan dan Temukan File Tema yang Benar

Di komputer Anda, ekstrak ZIP unduhan dari pengembang dan lihat isinya. Ada tiga kemungkinan yang akan Anda temui. Pertama, Anda menemukan satu ZIP lagi di dalamnya — ini kasus paling umum untuk tema premium. ZIP di dalam itulah file installable theme yang harus diunggah; abaikan dokumentasi dan file pendukung lainnya. Kedua, Anda menemukan folder tema yang di dalamnya langsung ada style.css, index.php, dan functions.php — folder inilah yang harus dikompres ulang menjadi ZIP baru (lihat Langkah 2). Ketiga, Anda tidak menemukan style.css di mana pun: kemungkinan Anda mengunduh paket yang salah, misalnya plugin yang dikira tema, atau tema untuk platform lain seperti Shopify atau Drupal. Periksa halaman produk tempat Anda membeli: pastikan tertulis WordPress sebagai platformnya sebelum melanjutkan.

Langkah 2: Kompres Ulang Folder Tema dengan Benar

Kesalahan paling umum pada langkah ini adalah mengompres folder induk yang membungkus folder tema, sehingga di dalam ZIP baru ada satu lapisan folder ekstra dan WordPress kembali tidak menemukan style.css di tempat yang diharapkan. Cara yang benar: masuk ke dalam folder hasil ekstraksi, pilih folder tema itu sendiri — folder yang langsung berisi style.css — lalu kompres folder itu. Jangan memilih folder induknya, dan jangan memilih file-file di dalamnya satu per satu tanpa folder pembungkusnya. Hasilnya adalah ZIP yang ketika dibuka langsung menampilkan folder tema, dan di dalam folder itu ada style.css.

Langkah 3: Unggah Ulang Lewat Dashboard

Kembali ke dashboard WordPress, buka Appearance, Themes, Add New, lalu Upload Theme. Pilih ZIP tema yang benar dari Langkah 1 atau 2, lalu klik Install Now. Jika instalasi berhasil, Anda akan melihat tombol Activate. Jangan langsung mengaktifkan di situs produksi bila Anda sedang mengganti tema aktif: periksa dulu pratinjau dan pastikan widget serta menu Anda tetap masuk akal di tema baru, karena pergantian tema bisa mengubah tampilan area widget dan menu. Setelah yakin, klik Activate, lalu bersihkan cache browser dan cache plugin bila tampilan terasa belum berubah.

Langkah 4: Bila Masih Gagal — Periksa Header style.css dan Child Theme

Jika ZIP sudah benar tetapi instalasi masih gagal, buka file style.css di dalam folder tema dan periksa baris komentar di bagian atasnya. Minimal harus ada baris seperti ini:

/*
Theme Name: Nama Tema Anda
Version: 1.0.0
*/

Untuk child theme, ada satu baris tambahan yang wajib ada dan sering menjadi penyebab gagal:

Template: nama-folder-tema-induk

Nilai Template harus sama persis dengan nama folder tema induknya — huruf kecil, sesuai ejaan, tanpa spasi tambahan. Jika nilainya salah, WordPress menganggap tema induknya tidak ada dan tema anak itu tidak bisa dipakai. Jika header hilang atau rusak dan Anda bukan pengembang temanya, jangan menambal file itu sendiri dengan tebakan: hubungi pengembang tema atau unduh ulang paket yang utuh, karena tema yang kehilangan identitasnya sering kehilangan bagian lain juga.

Alternatif: Instalasi Lewat FTP atau File Manager

Bila unggahan lewat dashboard terus gagal karena batas ukuran file di server, Anda bisa mengunggah folder tema yang sudah diekstrak langsung ke /wp-content/themes/ lewat FTP atau file manager hosting. Pastikan folder yang diunggah adalah folder tema itu sendiri (yang berisi style.css), bukan folder induk paket unduhan. Setelah unggahan selesai, tema akan muncul di Appearance, Themes dan bisa diaktifkan dari sana. Cara ini melewati batas unggahan dashboard, tetapi tetap mengikuti aturan yang sama: style.css harus berada di folder utama tema.

Verifikasi Hasil

Instalasi dinyatakan berhasil bila tema muncul di Appearance, Themes tanpa pesan broken, bisa dipratinjau dengan benar, dan setelah diaktifkan, situs menampilkan gaya tema baru (bukan halaman tanpa gaya). Jika tema muncul tetapi ditandai broken atau tanpa stylesheet, kembali ke Langkah 1 dan periksa lagi isi ZIP-nya — hampir selalu ada satu lapisan folder ekstra yang tertinggal.

Troubleshooting Lanjutan

Situasi	Langkah berikutnya
ZIP berisi dokumentasi dan satu ZIP lain	Unggah ZIP di dalamnya, bukan paket luarnya
Tidak ada style.css di mana pun	Kemungkinan paket yang salah: plugin, atau tema untuk platform lain; unduh ulang dari sumber resmi
Child theme gagal diaktifkan	Periksa baris Template di style.css: harus sama persis dengan nama folder tema induk
Unggahan dashboard selalu gagal	Gunakan FTP ke /wp-content/themes/ atau minta hosting menaikkan batas unggahan

FAQ

Apakah kegagalan ini merusak situs saya?

Tidak. Instalasi yang gagal ditolak sebelum tema apa pun diganti, sehingga tema lama Anda tetap aktif dan situs tetap tampil seperti biasa.

Kenapa tema dari WordPress.org jarang menimbulkan error ini?

Karena direktori tema WordPress.org hanya menerima paket tema yang strukturnya sudah benar. Error ini jauh lebih sering muncul pada tema premium, yang unduhannya dibungkus bersama dokumentasi, lisensi, dan konten demo.

Bolehkah saya membuat sendiri file style.css yang hilang?

Anda bisa, tetapi itu hanya menambal identitas tema, bukan memperbaiki tema yang kehilangan file. Bila file hilang dari paket resmi, lebih aman menghubungi pengembang atau mengunduh ulang paket yang utuh.

Kesimpulan

Stylesheet is missing hampir selalu berarti satu hal: Anda mengunggah paket yang salah, bukan tema yang rusak. Bongkar paket unduhan, temukan folder atau ZIP yang di dalamnya langsung ada style.css, kompres ulang dengan benar bila perlu, lalu unggah file itu. Setelah strukturnya benar, WordPress akan mengenali tema Anda dan instalasi berjalan seperti biasa.

Referensi

• Kinsta — "How to fix 'The package could not be installed. The theme is missing the style.css stylesheet'": penyebab utama (paket ZIP di dalam ZIP, pengunggahan yang salah) dan solusinya — https://kinsta.com/blog/the-package-could-not-be-installed/ (dibuka 28 Okt 2026).
• BlogVault — "Dealing With the 'Stylesheet is Missing' Error? Fix It In 7 Simple Steps": pemeriksaan isi file, kompres ulang folder tema, dan unggahan lewat dashboard atau FTP — https://blogvault.net/stylesheet-is-missing/ (dari hasil pencarian 28 Okt 2026).