Customizing Error Pages

These instructions apply to free BigCommerce themes that have not been customized. The BigCommerce Support Team may not be able assist with issues that occur after applying them to a previously customized theme. As always, we recommend backing up your current theme customizations before making any changes.

Don't feel comfortable adjusting your design or want to work with an expert? Check out our BigCommerce approved agencies or our Community Forum.

Customizing the 404 Error Page

The 404 error page is shown when a customer accesses a non-existent page. For example, a removed product page. By default it displays the following message:

The page you were looking for appears to have been moved, deleted or does not exist.

This is most likely due to:

  • An outdated link on another site
  • A typo in the address / URL

Follow these steps to customize the 404 error page's text.

Always back up your theme files before attempting any changes.

1. Go to Storefront DesignDesign Options, then click Edit HTML/CSS.

Edit HTML/CSS button

 

Did you know? You can also access your theme's template files by going to Storefront Design › Design Option, clicking the More tab and selecting Template Files. This list gives you the ability to edit, compare against the template default, and revert files to their default.

2. In the list of Other Template Files on the left, select 404.html.

The 404.html template file

3. Locate and replace any of the following variables with the text you’d like to appear on the page instead.

  • %%LNG_NotFound%% — displays “Not Found”
  • %%LNG_NotFoundError%% — displays “The page you were looking for appears to have been moved, deleted or does not exist.”
  • %%LNG_NotFoundReasonTitle%% — displays “This is most likely due to:”
  • %%LNG_NotFoundReason1%% — displays “An outdated link on another site”
  • %%LNG_NotFoundReason2%% — displays “A typo in the address / URL”

Advanced users who are comfortable with HTML, can add elements to the template as well.

4. Save your changes.

The Save button.

Customizing the 403 Error Page

The 403 error page is shown when a customer does not have the permissions necessary to view a particular category, product or web page. By default it displays the following message:

You Do Not Have Permission To Access This Page

You don't have the necessary permissions to view this page.

If you believe this is an error, please contact us at [administrator's email].

Return to the home page.

Follow these steps to customize the 403 error page's text.

Always back up your theme files before attempting any changes.

1. Go to Storefront DesignDesign Options, then click Edit HTML/CSS.

Edit HTML/CSS button

2. In the list of Other Template Files on the left, select 403.html.

The 403.html template file listing.

3. Locate and replace any of the following variables with the text you’d like to appear on the page instead.

  • %%LNG_ForbiddenAccessPage%% — displays “You Do Not Have Permission To Access This Page”
  • %%LNG_NoPermissionToAccessThisPage%% — displays “You don't have the necessary permissions to view this page.”
  • %%GLOBAL_Contact%% — displays “If you believe this is an error, please contact us at [administrator's email].”
  • %%LNG_ReturnToHomepage%% — displays “Return to the home page.”

The administrator's email address can be updated by going to SettingsStore SetupStore Settings, then clicking on the Miscellaneous tab.

4. Save your changes.

The Save button.

Mobile Theme Error Pages

The BigCommerce mobile theme's 403.html and 404.html error page template files contain the same variables as listed above. See Customizing the BigCommerce Mobile Theme for instructions on downloading, customizing, and uploading changes to the BigCommerce mobile theme.

Was this article helpful?