Customize access denied page in SharePoint 2013/2016

In this SharePoint customization tutorial, I will explain how to customize access denied page in SharePoint 2013/2016.

After customizing the entire site user wants to redirect all the non-existed users to a different page with custom access denied message. In this article, I would like to walk you through the approach to update/associate a web application with custom access denied page.

The default access denied page for SharePoint 2013 resides at \Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\LAYOUTS\ AccessDenied.aspx

Customize access denied page in SharePoint 2013/2016

Follow the below steps to customize access denied page in SharePoint 2013/2016.

First, we need to change the default association by following the below steps:

Log on to SharePoint WFE environment with a FARM admin account

Open the windows explorer and navigate to the layouts folder
\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\LAYOUTS

Create a new folder called “UserCustomPages” under LAYOUTS folder

Copy the AccessDenied.aspx page to a newly created folder.

sharepoint 2013 customize accessdenied.aspx
sharepoint 2016 customize access denied page

Edit the access denied page with the custom message after “ms-accessDenied-reqDialog” tag as shown below.

sharepoint 2013 customize access denied page

We can see in the below screen with default AccessDenied mapping and newly user-created access denied page.

sharepoint customize access denied page

Note: You might have noticed that sharepoint associate the AccessDenied page as a relative path. The actual file resided in “\Program Files\Common Files\microsoft shared\Web Server Extensions\15\TEMPLATE\LAYOUTS\UserCustomPages” the relative path for the same is “/_layouts/15/UserCustomPages/UserCustomAccessDenied.aspx”

PowerShell Command set custom access denied page in SharePoint

Below, is the PowerShell script to set a custom access denied page in SharePoint 2013/2016.

Syntax:
Set-SPCustomLayoutsPage -Identity "AccessDenied" -RelativePath "<< Custom relative path >>" -WebApplication "<<Web Application URL >>"

Example:
Set-SPCustomLayoutsPage -Identity "AccessDenied" -RelativePath "/_layouts/15/UserCustomPages/UserCustomAccessDenied.aspx" -WebApplication "http://sharepoint13:12345"

As soon as mapping completed login to SharePoint site with an unauthorized user and it will show the below new user access denied page.

sharepoint custom access denied page

You may like the following SharePoint customization tutorials:

In this SharePoint tutorial, we learned how to create custom access denied page in SharePoint 2013/2016, and also, we saw how to set custom access denied page in SharePoint 2013/2016 using PowerShell.

>