Skip to content
The HTML5 Boilerplate adapted into a WordPress template, including Bruce Lawson's HTML5 blog markup. This is walker trying to take Steve Heffernan's work further.
PHP Perl Other
Pull request Compare This branch is 133 commits ahead, 4 commits behind zencoder:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


HTML5 Boilerplate for Wordpress

This theme is built on HTML5 Boilerplate by Paul Irish and Divya Manian. The sole purpose of this theme is to save developers the time it takes to apply the HTML5 Boilerplate to WordPress. The "HTML5 Boilerplate" name is used with permission from Paul Irish. (This is from the original file by zencoder. Walker forked his and assumes this is still alright to use.)

The layout is based on Bruce Lawson's Designing a Blog with HTML5

Instead of using only DIVs for content layout, it uses new HTML5 tags, including header, footer, nav, article, and section.

It's a very bare layout, including only the base styles that come with the boilerplate and required WordPress styles, so layout is up to you. Alternatively, you could apply the methods used here to other themes.

To Get Repo

  1. git clone
  2. cd html5-boilerplate-for-wordpress

Getting Started

  1. Add the html5-boilerplate-for-wordpress folder to your wp-content/themes folder.
  2. Activate the theme. WP-Admin > Appearance > Themes
  3. Add some of the "Root Files" to the root directory of your website (explained below).
  4. Style away, knowing that you're building on a super solid base with HTML5 awesomeness.

Root Files

These files can be found in the theme. Some of the files listed here should be (carefully) moved to the root of your site (same level as the wp-content directory). Read on for specific instructions.

404 Page

If you use permalinks (WP-Admin > Settings > Permalinks), then WordPress handles any 404s with the 404.php included in the theme.


Do not copy to the root of your site. This may overwrite the WordPress htaccess, and break Wordpress. Instead, copy and paste the contents of this file to the .htaccess already at the root of your site, after the existing content. It would be good to make a comment where the Boilerplate content begins, like "# Begin HTML5 Boilerplate". Read htaccess file for more info on what it does. This file may not be visible if you're viewing the folder on your computer. Files that start with a "." are often hidden. It should be visible through your FTP browser once uploaded.


If you don't know what this is, you probably don't need it.


Tells all search engines that they can read and index all pages. This is handled by WordPress so you shouldn't need to move this to the root.


Feel free to edit this and move to root.

Root Images

These are some images you might put in your site root.


The favicon is the icon shown to the left of the URL at the top of your browser window. You should move this to the root of your site (same level as the wp-content directory) if you can.


On iPhones and iPads you can book mark a web page and have it show up on the home screen as an icon. The apple-touch-icon.png becomes this icon if used. Rounded corners and glossy finish are added by the device. You should move this to the root of your site (same level as the wp-content directory) if you can.

Something went wrong with that request. Please try again.