You are here:
Use a Custom Service Unavailable Page in Your Salesforce Tabs + Visualforce Site
On rare occasions, if your Salesforce Tabs + Visualforce site isn’t available because of a service outage, Salesforce displays a generic Service Not Available page with Lightning Platform branding. You can replace this page with a custom company-branded static resource page for a personalized user experience for your Salesforce Tabs + Visualforce site members.
Required Editions
| Available in: Salesforce Classic and Lightning Experience |
| Available in: Enterprise, Performance, Unlimited, and Developer Editions |
| Applies to: LWR, Aura, and Visualforce sites |
The Service Not Available static resource:
- Must be a public .zip file 5 MB or smaller.
- Must contain a page named maintenance.html at the root level of the .zip file. Other resources in the .zip file, such as images or CSS files, can follow any directory structure.
- Must contain only files that have file extensions.
For more information, refer to Assigning Salesforce Site Error Pages in Salesforce Help.
- Open Experience Workspaces.
- Navigate to Administration | Pages.
-
To search for and select your custom page, click
next to Service Not Available.
- Click Save.
If there’s a service outage at any time, your community displays your selected page. A couple things to keep in mind:
- This page selection doesn’t affect sites that use Site.com Studio pages.
- The Service Not Available page, after it’s customized, is available for all Salesforce
Tabs + Visualforce sites in the same domain. To avoid using the same page for all the
sites in your domain, create and assign separate Service Not Available pages for each
site.
For example, consider a scenario where you have two Salesforce Tabs + Visualforce sites in your domain: a customer community (universaltelco.my.site.com/customer) and a partner portal (universaltelco.my.site.com/partner). If you use a custom Service Not Available page for the customer community, then the partner portal displays the same page during a service outage. You can create and assign a separate Service Not Available page to the partner portal.
Domains with a custom URL that contains a root path prefix use the site's Service Not Available page for paths that aren't custom URLs of other sites and have their own Service Not Available pages.
For example, sites https://www.example.com/ and https://www.example.com/site1 have assigned Service Not Available pages. Site https://www.example.com/site2 doesn’t have an assigned Service Not Available page.
Requests to https://www.example.com/, https://www.example.com/Page1, and https://www.example.com/site2 display the Service Not Available page assigned to https://www.example.com/.
Requests to https://www.example.com/site1 and https://www.example.com/site1/Page1, display the Service Not Available page assigned to https://www.example.com/site1.
If a site doesn’t have an assigned Service Not Available page, and the sites of parent custom URLs in the same domain also don't have assigned Service Not Available pages, the Maintenance page is displayed.
-
In certain circumstances, when you configure your site to display a custom error page, your site displays the standard Service Not Available page instead. This change happens by design when you switch to using the Salesforce content delivery network (CDN). This change also happens for sites that switch to using enhanced domains, because the Salesforce CDN is enabled by default for enhanced domains. For more information, see Assigning Salesforce Site Error Pages.
