💡 ULASAN & REFERENSI • DIPERBARUI: 26 October 2026 • REDAKSI AZWINN

Cara Setting ErrorDocument di Htaccess untuk Kustomisasi Error

Mengatur ErrorDocument di dalam file .htaccess memungkinkan Anda mengubah tampilan halaman error standar server (seperti 403 Forbidden atau 404 Not Found) menjadi halaman kustom yang sesuai dengan desain situs web Anda. Pengaturan ini sangat penting untuk meningkatkan pengalaman pengguna sekaligus menjaga profesionalisme situs.

Untuk mulai menggunakan direktif ini, Anda perlu mengakses direktori root website melalui FTP atau cPanel File Manager, lalu menyunting atau membuat file bernama .htaccess. Berikut adalah sintaks dasar dan panduan lengkap penerapannya.

Sintaks Dasar ErrorDocument

Format penulisan perintah ErrorDocument di dalam file .htaccess terdiri dari nomor kode status HTTP diikuti oleh jalur (path) menuju file halaman error kustom Anda.

ErrorDocument 403 /error/403.html
ErrorDocument 404 /error/404.html
ErrorDocument 500 /error/500.html

Tabel Referensi Kode Status HTTP untuk .htaccess

Kode Status Nama Error Deskripsi Singkat
400 Bad Request Permintaan dari peramban tidak dapat dipahami oleh server.
401 Authorization Required Pengguna memerlukan otentikasi atau login untuk mengakses halaman.
403 Forbidden Server menolak memberikan akses ke halaman tersebut (terkait izin akses).
404 Not Found File atau alamat URL yang diminta tidak ditemukan di server.
500 Internal Server Error Terjadi kesalahan tak terduga pada sisi server saat memproses permintaan.

Langkah-Langkah Implementasi Teknis

  1. Buat file halaman kustom untuk masing-masing error, misalnya 403.html atau 404.html, dan letakkan dalam folder khusus seperti direktori /error/.
  2. Buka file .htaccess yang berada di root direktori website Anda menggunakan teks editor atau File Manager.
  3. Tambahkan baris kode ErrorDocument [kode_error] [lokasi_file] seperti contoh sintaks di atas.
  4. Simpan perubahan dan lakukan pengujian dengan mengakses URL yang sengaja dibuat salah atau dibatasi untuk memastikan halaman kustom tampil dengan sempurna.

Tips Troubleshooting Lapangan

Jika halaman kustom Anda tidak muncul dan server tetap menampilkan pesan error bawaan (default), periksa beberapa hal berikut:

  • Pastikan jalur (path) file error yang Anda tuliskan sudah benar relatif terhadap root direktori.
  • Beberapa peramban seperti Internet Explorer atau versi lama Chrome memiliki fitur "Friendly HTTP error messages" yang dapat menimpa halaman kustom Anda jika ukuran file error kurang dari 512 byte. Pastikan file HTML Anda memiliki konten yang cukup atau tambahkan komentar padding.
  • Periksa konfigurasi izin akses (file permissions) pada file halaman error kustom agar dapat dibaca oleh server web (umumnya disetel ke 644).

🔍 Orang Lain Juga Mencari Ini