Custom Site Maintenance Page

This topic applies to

Applies to

SuiteCommerce Web Stores




You can design and upload a custom maintenance page to display while you complete routine updates and during NetSuite scheduled maintenance periods. By designing your own maintenance page, you can continue to communicate your brand message even when your site is offline.


Maintenance domains and displaying a custom site maintenance page are not supported on Sandbox.

To set up the maintenance page, you must configure your own site maintenance domain name with your DNS provider. Next, upload assets for your site maintenance page in the file cabinet in NetSuite. Then, create the maintenance domain and designate the maintenance folder. Finally, on the domains page in NetSuite, associate the site maintenance domain with a website domain.

All files in the folder that you use to store your maintenance page are publicly accessible using the site maintenance domain. Note that SSP files and touch points are not supported. Also, SuiteScript is not executed on files in the site maintenance folder. If you use multiple websites, you can create a different site maintenance domain for each website domain.

To set up a custom site maintenance HTML page:

  1. Create a domain name to use when your site is offline for maintenance, for example,

    1. Configure DNS settings with your domain provider.

    2. Point your site maintenance domain to <maintenancedomain> For example, if the maintenance domain is, point it to See Link your Domain Name with your NetSuite Domain for more information.

  2. In NetSuite, create a subfolder in the Web Site Hosting Files folder to host the assets for your maintenance page. There is a 10 MB size limit to the folder you use for hosting your site maintenance page.

  3. Upload the assets for your maintenance page in the folder you created. Your assets must include a file named index.html.

  4. Go to Setup > Site Builder/SuiteCommerce Advanced > Site Maintenance Domains > New.

    1. Enter your Site Maintenance Domain Name. This is the domain name you configured in Step 1.

    2. Select a Site Maintenance Folder. This is the folder you created in Step 2.

    3. Click Save.

  5. Use the Domains page in NetSuite to map the site maintenance domain to your website shopping domain.

    1. Go to Setup > Site Builder/SuiteCommerce Advanced > Domains > New.

    2. Click the website domain name to associate with the site maintenance domain, then select a domain in the Site Maintenance Domain column. You can select a different site maintenance domain for each website domain.

    3. Click OK.

    4. Click Save.

After you enter your new site maintenance domain in NetSuite (Step 4), it can take from 5 minutes up to 30 minutes to display your content online. To preview or test your maintenance page, open a new browser and navigate directly to the site maintenance domain. For example, to preview your maintenance page, go to


Any time you change the maintenance domain, the Site Maintenance Folder or its contents, there is a lag time of about five minutes before you can see changes to the page.