---
title: "Customizing Unauthorized page"
slug: "unauthorized-page"
description: "'Unauthorized page' appears when a user with no access permission in your Knowledge base tries to access a Knowledge base site URL."
tags: ["Error pages", "Customize site"]
updated: 2026-03-10T08:15:48Z
published: 2026-03-10T08:15:48Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Customizing Unauthorized page

The **Unauthorized**page appears when a user without proper permissions attempts to access a restricted URL in your knowledge base. For example, this page will display if a user tries to access private content without the necessary access rights.

To improve user experience, you can customize the Unauthorized page by adding a descriptive message that explains the reason for restricted access and provides a solution, such as: “You don’t have permission to view this page. Contact your admin to request access.”

> [!NOTE]
> ** NOTE
> 
> Once you configure a **custom unauthorized** page, it cannot be reverted to the default version. We recommend creating a custom unauthorized page to enhance the user experience.

![2_Screenshot-Example_Unauthorized_denied_custom_page](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_Screenshot-Example_Unauthorized_denied_custom_page.png)

---

## Customizing the Unauthorized page

Follow these steps to customize the Unauthorized page:

1. Navigate to **Settings** (**) > **Knowledge base site** in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Site customization**.

The **Site customization** page contains all the basic site design configurations.
3. Click **Customize site**.

![Site customization options for branding, including theme selection and logo upload.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Customize-site.png)
4. From the left dropdown menu, select **Unauthorized**page.
5. Customize the page using one of two options:
  - **Basic style**: Customize the default image and text.
  - **Custom style**: Add your own HTML and CSS for a fully personalized page.****Use the **Preview** toggle to switch between code view and rendered view.
6. Click **Save******to save your changes without applying them immediately.
7. Click **Preview** to see how your changes will appear on the knowledge base site.
8. Click **Publish******to make your recent changes visible to readers.
9. Click the **More** (**) icon and select **Reset to published version** to discard all saved and unsaved customizations and revert to the last published version.

> [!NOTE]
> ** NOTE
> 
> The **Reset to published version** feature is available only for new Knowledge base site 2.0 projects created after March 29, 2025.

![Unauthorized access message displayed on a mobile interface with user profile illustration.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1773130530752.png)

---

### Basic style

#### Adding an image

To enhance the page visually, you can upload a relevant image.

1. Click **Image**.

The **Image** panel will appear.
2. Click **Change** and choose between two options:

a. **Default images**: Select from the default images and click **Save**.

b. **Image**: Either provide a URL or upload an image from your drive.
  - To upload from URL: Enter the image URL in the URL field and click **Save**.
  - To upload from your drive: Click **Upload an image**, select the file, and click **Save**.
3. Set the image alignment (left, center, or right) as needed.

![User interface showing image selection options and alignment settings for customization.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1773130498341.png)

#### Updating the heading

1. Click **Heading**.

The **Heading**panel will appear.
2. Enter the desired heading text.
3. Select a color from the text color palette.

> The default heading will be "Sorry!".

![A warning message indicating unauthorized access with a heading saying 'Sorry!'](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1773130475067.png)

#### Updating the paragraph

1. Click **Paragraph**. The **Paragraph** panel will appear.
2. Enter a description for the page. This will help readers understand the context.
3. Select a color from the text color palette.

> The default paragraph will be “You are not authorized to access this article or page.”

![User is notified they are not authorized to access the article or page.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1773130453853.png)

### Custom style

Customize the **Unauthorized**page with HTML or CSS section.

1. Select **Custom style** and switch between the **HTML** and **CSS** sections.
2. Update the code as required in each section.
3. Turn on the **Preview** toggle to view the updated page.
4. Once done, click **Save** and **Publish**.
5. Click **Save******to save your changes without applying them immediately.
6. Click the **More** (**) icon and select **Reset to published version** to discard all saved and unsaved customizations and revert to the last published version.

> [!NOTE]
> ** NOTE
> 
> The **Reset to published version** feature is available only for new Knowledge base site 2.0 projects created after March 29, 2025.

![Unauthorized access message with options to customize site settings and logout.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1773130432245.png)

## Related

- [Error pages](/error-pages.md)
- [Customizing Access denied page](/access-denied-page.md)
- [Customizing 404 page](/404-page.md)
