🔧 Edgy

The Skinny

Need a lightning-fast, on-demand maintenance page? Well you're lookin' at it. Edgy is a customizeable maintenance page that can be toggled on and off as needed. It can even be set up on a per-route basis if you don't need to take your entire site offline.

How to Install

Powered by Cloudflare

Edgy is powered by Cloudflare. If you're already using Cloudflare, click here to install Edgy.

TIP

Cloudflare offers DDoS protection, a global CDN, SSL certificates, and a lot more cool stuff for free. You should probably use it.

Configuration

Edgy is dirt simple to set up. You can get the gist of it from the installation page, but we'll dig into the nuts and bolts below.

TIP

Edgy is available in three Tiers — Free, Plus, and Pro. The Free tier includes a configureable global maintenance page, the Plus plan unlocks custom templates, and the Pro plan gives you route-based maintenance pages.

The following Default Page Options are available for all tiers:

The following Template Configuration is available on the Plus and Pro tiers:

These Route Based Options are available on the Pro tier:

TIP

Page Templates are displayed in rank order. Route Template has precedence over Custom Template, which has precendence over Default Page. For example, A Pro user may use the Default Page on selected routes by leaving Custom Template and Route Template blank.

Activate Maintenance Mode all

Activate maintenance mode globally.

TIP

This option overrides any route-based Activate Maintenance Mode selections.

Default Page Options free plus pro

The Default Page is available to all users. Plus and Pro users may use the Default Page by leaving Custom Template and Route Templates blank. It will be displayed without the 🔌 by edgy attribution.

Site Name

The name of your site to be displayed in the <title> attribute of the Default Maintenance Page. The title of the page will be [Site Name] | Under Maintenance.

Heading Text

The Heading text to display in the Default Maintenance Page.

TIP

The Heading Text is "We're undergoing a bit of scheduled maintenance" in the Themes images below.

Subheading Text

The Subheading text to display in the Default Maintenance Page.

TIP

The Subheading Text is "We'll be back online" in the Themes images below.

Theme

Choose from one of the following themes for the Default Maintenance Page.

Black & White Theme

Black & White Theme

Rustic Theme

Rustic Theme

Modern Theme

Modern Theme

Surreal Theme

Surreal Theme

Template Configuration plus pro

Custom Template

Template to display as your maintenance page. If this is unset, the Default Maintenance Page will be displayed. All media sources must be hosted by another provider. Refer to the following table for more information.

Image src attribute Result
../assets/my-image.png 🤮
http://somehost.com/my-image.png 🎉

WARNING

Do not include base64 encoded images in your template due to strict template size restrictions.

Response Status

HTTP status code to return along with the maintenance page. A 200 is returned by default, but any number between 200 and 600 is valid. Responding with an unusual status code can be useful if you're using site reliability software to monitor your site.

Route Based Options pro

Route URL

The maintenance page will be displayed on this URL. This can be any URL on your domain and can include subdomains. It is important that a full URL is specified here. Edgy won't like it if you supply a path like /store here. It requires a URL like yoursite.com/store to work right. Here's some more examples in an informative table.

Route URL Result
/sad/path 🤮
yoursite.com/cool-beans 🎉
blog.yoursite.com 🎉

Edgy will automatically display for any requests to subfolders of Route URL. In the table above, traffic to blog.yoursite.com/topics will also go to the maintenance page.

Route Template pro

Maintenance template to display on this route. If this is unset, the Custom Template will be displayed instead. All media sources must be hosted by another provider. Refer to the following table for more information.

Image src attribute Result
../assets/my-image.png 🤮
http://somehost.com/my-image.png 🎉

WARNING

Do not include base64 encoded images in your template due to strict template size restrictions.

Activate Maintenance Mode pro

Activate maintenance mode on this route only. The rest of your website will still behave normally.

Attributions

The Default Maintenance Page gear logo was designed by Icongeek26 at FlatIcon.

The Default Maintenance Page surreal drawings were made by a talented human at Absurd Design.