How to Use AddDefaultCharset in Apache

The AddDefaultCharset directive in Apache sets the default character encoding (charset) for documents served by the server. It ensures that clients (browsers) correctly interpret the text content when no charset is explicitly specified in the document or HTTP headers.

For the .htaccess-focused variants of the same directive, see AddDefaultCharset in .htaccess: Ensuring File Encoding and How to Use AddDefaultCharset UTF-8 in .htaccess.

You can use AddDefaultCharset in the following places:

• Apache global configuration file (e.g., httpd.conf or apache2.conf).
• Virtual host configuration for specific websites.
• .htaccess file in the root directory of your website.

AddDefaultCharset charset

• charset: The character encoding to apply (e.g., UTF-8, ISO-8859-1, windows-1251).
• If Off is specified, no default charset is sent unless specified in the content or header.

To apply globally across all websites hosted on the server:

1. Open the Apache configuration file:

sudo nano /etc/apache2/apache2.conf    # For Ubuntu/Debian
sudo nano /etc/httpd/conf/httpd.conf   # For CentOS/RHEL

2. Add the directive:

AddDefaultCharset UTF-8

3. Restart Apache:

sudo systemctl restart apache2   # For Ubuntu/Debian
sudo systemctl restart httpd     # For CentOS/RHEL

To set the charset for a specific website or domain:

1. Open the virtual host configuration file:

sudo nano /etc/apache2/sites-available/yourdomain.conf    # Ubuntu/Debian
sudo nano /etc/httpd/conf.d/yourdomain.conf               # CentOS/RHEL

2. Add the directive inside the <VirtualHost> block:

<VirtualHost *:80>

    ServerName yourdomain.com

    DocumentRoot /var/www/yourdomain

    AddDefaultCharset UTF-8

</VirtualHost>

3. Restart Apache:

sudo systemctl restart apache2

To apply the directive to a specific directory or website:

1. Open or create the .htaccess file in the root directory of your website:

nano /var/www/yourdomain/.htaccess

2. Add the directive:

AddDefaultCharset UTF-8

1. Access your website in a browser and inspect the HTTP headers.
   • Use the Developer Tools > Network Tab > Select the Request > Headers.
   • Look for the Content-Type header, which should show:

   Content-Type: text/html; charset=UTF-8

2. Alternatively, test using curl:

curl -I http://yourdomain.com

Output example:

Content-Type: text/html; charset=UTF-8

• If a document (e.g., HTML, PHP) does not explicitly set a charset in its <meta> tag or HTTP headers, Apache sends the charset defined by AddDefaultCharset in the response headers.
• Example HTTP Header:

Content-Type: text/html; charset=UTF-8

The AddDefaultCharset directive is a simple and effective way to ensure that browsers interpret your content with the correct encoding. However, use it carefully, ensuring that it aligns with the encoding of your files and database. When possible, prefer using UTF-8 for better compatibility and consistency.