1. Home
  2. Go Live Processes
  3. Building the .htaccess File

Building the .htaccess File

You will need your 301s before you can create a complete the .htaccess file.

Overview

This .htaccess configuration is optimized for our Plesk/Nginx environment, addressing common scenarios like domain redirection and URL rewriting, specifically for our needs.

Copy and paste the content below into your .htaccess file or download the template from the link above.

# .htaccess Configuration Template
# Version: 4.1
# Date: 2026-08-14
# Deploy: Plesk Files → httpdocs/.htaccess AFTER last CMS Publish.
# Never Publish after. nginx must not serve .html.

# AddType application/x-httpd-php .html

Options +FollowSymLinks -MultiViews

RewriteEngine On
RewriteBase /

# ---- HTTPS Enforcement ----
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# ---- Non-www to www (HTTPS) ----
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteCond %{HTTP_HOST} !^localhost [NC]
RewriteCond %{HTTP_HOST} ^(.+)$ [NC]
RewriteRule ^(.*)$ https://www.%1/$1 [L,R=301]

# ---- Index.html to root ----
RewriteCond %{THE_REQUEST} /\index\.html [NC]
RewriteCond %{REQUEST_URI} !^/blog/ [NC]
RewriteRule ^index\.html$ / [L,R=301]

# ---- CSS/JS versioning ----
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.+)\.(\d+)\.(bmp|css|cur|gif|ico|jpe?g|js|png|svgz?|webp|webmanifest)$ $1.$3 [L]

# ---- 404 (do NOT 301 unknown URLs to homepage) ----
ErrorDocument 404 /404.html

# ---- Specific Page Redirects ----
# Redirect 301 /old-path.html https://www.YOURDOMAIN.com/new-path.html

Instructions for Creating and Editing.htaccess

  1. Creating the File: Use a text editor to create a file named .htaccess and place it in the directory you want to control.
  2. Editing the File: Use a text editor to add or modify directives.
  3. RewriteCond RewriteRule Directives: Leave ALL 3 Sets of if Unsure:
  4. Customize for Your Domain: Replace oldexample.com and newexample.com with your actual project URLs.

Backup: Always back up your .htaccess file before making changes.

Testing and Deployment

  1. Test your .htaccess file in a staging environment to ensure all redirects work as expected.
  2. Deploy final .htaccess file to your live environment.
  3. Use .htaccess tester tools to verify your rules.
  4. Monitor your website to ensure all redirects are functioning correctly.

made with love – .htaccess tester

Updated on September 3, 2024
Was this article helpful?

Related Articles