Displaying a Custom Error Page with Backplane

Laura Franzese
Backplane.io Blog
Published in
1 min readSep 22, 2017

Backplane now allows users to create custom error pages. This streamlines the user-experience when an error occurs. By default, when Backplane encounters an error proxying a request, it will serve the generic backplane branded error page.

The custom error page feature allows you to personalize the page that appears if Backplane is unable to find a backend, or when a user is denied access by any configured security settings of the endpoint. Backplane customers can now configure error pages to provide their own branding, and helpful instructions on what to do next, or where to go.

Getting Started

To create your own custom error page use the Backplane CLI or API.

To use the CLI first make sure your version is up to date (version 1.4.7 is required). Use the `backplane error` command, eg `backplane error myendpoint.com 503 https://customerrorpage.s3.com/503.html`.

To use the API send a POST request to /error with the body `{“Pattern”:”myendpoint.com”,”StatusCode”:503,”URL”:”https://customerrorpage.s3.com/503.html"}`

Tell Us

What are your favorite custom error pages? Tweet us @backplaneio and your tweet could be included in one of our upcoming posts.

--

--

Laura Franzese
Backplane.io Blog

Building all things marketing, communications + community @backplane