From 6141b60efb3adb2cc21a195577f431adc81b184c Mon Sep 17 00:00:00 2001 From: robinsowell Date: Thu, 5 Mar 2026 09:47:09 -0500 Subject: [PATCH 1/2] Adding docs on troubleshooting Live Preview http auth issues --- docs/control-panel/create.md | 4 +++- docs/installation/requirements.md | 6 ++++++ docs/troubleshooting/error-messages.md | 11 +++++++++++ 3 files changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/control-panel/create.md b/docs/control-panel/create.md index fd64bf00d..5ce50b976 100755 --- a/docs/control-panel/create.md +++ b/docs/control-panel/create.md @@ -192,10 +192,12 @@ Saves the entry and returns the [Entry Manager](control-panel/entry-manager.md) ### Preview -A live preview of the entry is available if the `channel_prefs_preview_url` is set **or** the [Pages Module](add-ons/pages.md) is installed and a Page URI and template have been set. +A live preview of the entry is available if the relavant Channel's [Preview URL](control-panel/channels.md#settings-tab) is set **or** the [Pages Module](add-ons/pages.md) is installed and a Page URI and template have been set. If neither is set, the preview button will have an exclamation mark (!) and will link to channel preferences page where Preview URL can be set. The preview will open a split screen that allows a live preview of edits. The template used to display the preview is based on the Page fields if set and the channel preview URL otherwise. When the preview is triggered, it is being displayed side-by-side with edit screen. The size of preview container can be adjusted with mouse dragging its border. The preview is dynamically being updated as you change the fields. + +Live Preview does require the [HTTP Authorization Header be enabled](troubleshooting/error-messages.md#http-authorization-header-missing). diff --git a/docs/installation/requirements.md b/docs/installation/requirements.md index f200c79d9..2f9e2f42e 100755 --- a/docs/installation/requirements.md +++ b/docs/installation/requirements.md @@ -117,6 +117,12 @@ If you are hosted on an Apache server, the `AcceptPathInfo` option needs to be e - Ask your web host or server admin to enable the option - Set your site's URLs to use [query strings](general/url-structure.md#query-strings) +If on an Apache server and [Live Preview](control-panel/create.md#preview) shows an error message 'HTTP Authorization Header Missing', you will need to add this line of code to your your [.htaccess file](installation/best-practices.md#1-create-an-htaccess-file) + +```php +SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 +``` + ### URL Segment Support If the [Server Compatibility Wizard](#server-compatibility-wizard) lists URL Segment Support as _Unsupported_, you will need to set your site's URLs to use [query strings](general/url-structure.md#query-strings). diff --git a/docs/troubleshooting/error-messages.md b/docs/troubleshooting/error-messages.md index e49ac1cc2..8be97dde2 100755 --- a/docs/troubleshooting/error-messages.md +++ b/docs/troubleshooting/error-messages.md @@ -45,6 +45,17 @@ This error---and similar warnings such as **"Warning: imagettftext(): Could not If that is not an option, **Use TrueType Font for Captcha?** should be set to _No_ under `Settings --> CAPTCHA` or CAPTCHAs should be disabled altogether. +## HTTP Authorization Header Missing + +ExpressionEngine returns the following error message when attempting to use [Live Preview](control-panel/create.md#preview): **"HTTP Authorization Header Missing"** + +### Troubleshooting + +The HTTP_AUTHORIZATION environmental variable's value is stripped by some Apache servers, causing an error rendering the Live Preview. This behavior may be overriden in your [.htaccess file](installation/best-practices.md#1-create-an-htaccess-file) by adding the following line: + +```php +SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 +``` ## Warning: Cannot modify header information ExpressionEngine returns the following warning: **"Cannot modify header information."** From 995e28229ccc1c206ff3aa3edd7c591fceb05f74 Mon Sep 17 00:00:00 2001 From: robinsowell Date: Thu, 5 Mar 2026 11:04:50 -0500 Subject: [PATCH 2/2] Tweaked the troubleshooting for live preview fail description --- docs/troubleshooting/error-messages.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/troubleshooting/error-messages.md b/docs/troubleshooting/error-messages.md index 8be97dde2..e5fd572cd 100755 --- a/docs/troubleshooting/error-messages.md +++ b/docs/troubleshooting/error-messages.md @@ -51,7 +51,7 @@ ExpressionEngine returns the following error message when attempting to use [Liv ### Troubleshooting -The HTTP_AUTHORIZATION environmental variable's value is stripped by some Apache servers, causing an error rendering the Live Preview. This behavior may be overriden in your [.htaccess file](installation/best-practices.md#1-create-an-htaccess-file) by adding the following line: +The Authorization header is stripped by some Apache servers, causing an error rendering the Live Preview. This behavior may be overriden in your [.htaccess file](installation/best-practices.md#1-create-an-htaccess-file) by adding the following line: ```php SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1