Skip to content


Switch branches/tags

Latest commit

Bye by dead links or sites no longer using this theme. Also, CSS for sizing images added with Block Editor

Git stats


Failed to load latest commit information.
Latest commit message
Commit time

HTML5up Dimension Theme for Wordpress

If this kind of stuff has any value to you, please consider supporting me so I can do more!

Support me on Patreon Support me on via PayPal

A configurable Wordpress Theme version of HTML5up Dimension Theme made for the internet by @cogdog. It creates a simple, elegant calling card site, something that looks like

Screenshot of Theme

The box links below the headings each open content overlays, each a Wordpress post, internally on the site renamed "Front Boxes":

Sample Page

Editing options in the posts/front pages provide the means to add a button and link at the bottom that can go to any URL. You can also create standalone WordPress pages in case you have more info than you want to show in a front box.

Static Page


Search for other examples in The Google

Installing from Scratch

Install this theme on any self hosted Wordpress site. You cannot do this on, get a real web hosting package.

You can download a ZIP file of this theme via the green *Code" button above (use the Download Zip option).

The zip can be uploaded directly to your site via Themes in the Wordpress dashboard, then Add Theme and finally Upload Theme. If you run into size upload limits or just prefer going old school like me, unzip the package and ftp the entire folder into your wp-content/themes directory.

Updating the Theme

As of WordPress version 5.5 themes uploaded as .ZIP files can now be updated the same way you installed it; just download the newest version, and update it via Themes in the Wordpress dashboard, then Add Theme and finally Upload Theme. You will be asked to confirm updating the theme with the newer version.

If you have ftp/sftp access to your site (or this can be done in a cpanel file manager), simply upload the new theme files to the wp-content/themes directory that includes the older version theme.

For those that lack direct file upload access or maybe that idea sends shivers down the spine, upload and activate the Easy Theme and Plugin Upgrades plugin -- this will allow you to upload a newer version of a theme as a ZIP archive, the same way you add a theme by uploading.

Customizing with the Customizer

The main elements are set and previewed in Appearance -> Customize

Site Name and Tagline. Anything you want!

Under Site Identity edit to define the headline elements (leave blank to remove)

It says Set Headers but it's really Set Background. So sneaky!

Under Header Image upload an image (recommended size 1568 x 1024 px or bigger) to place a background image

The reason we use Header image controller, is you can upload more than one image, and use the option to randomize each time.

Front Quote and Footer

Under Dimension Front Text edit fields to add an optional quote (appears below tagline) and custom footer text

Any Footer text added will be placed before the current credits line at the bottom.

Front Icon

Under Dimension Logo upload your own image. Amazing!

Social Media Icons

NOTE Previous versions of the themes used the Font Awesome 4 Menus plugin, which is not compatible with the latest set of Font Awesome icons I have built an update to this plugin in you want access to a larger set of icons. You will also need to add fab to the menu class names (see below)

To have a customized set of icon links on the front of the site, download, install and activate the Font Awesome 5 Menus plugin. This allows you to add an icon to any menu item.

From the Wordpress Dashboard look under Appearances for Menus. Click create a new menu name it whatever you like -- social is a good choice. Under Menu Settings next to Display Location check the box for Social Media.

To add a social media (or any link), open the panel for Custom Link.

Enter a title for the site and provide the URL that points to your content on that site. Add as many as you like. You can drag and drop them to change the order.

To set the icon, you must first enable the visibility of CSS classes for each menu item. Click Screen Options in the upper right, and check the box for CSS Classes.

Open an item in your Social Menu and you will now see a field for entering CSS Class names. You have the choice to add from well over 1400 icons in the Font Awesome free collection. Find the name of the icon you wish to use, and enter it's all of it's class names as listed,

For example these are the class names to render the icon for typical social media sites (these should be all lower case):

  • fab fa-twitter
  • fab fa-facebook
  • fab fa-youtube
  • fab fa-linkedin
  • fab fa-instagram
  • fab fa-flickr

With the Font Awesome icons, you can add any site you wish to be represented on the front page and pick the icon you prefer.

Save your menu and check out the spiffy icons up front.

In addition, if you want to provide a tool tip hover for the icons, look again under Screen Options and enable the option for Title Attribute. This adds another editable field to add the tooltip text.

This provides a tool tip like

Buttons! On the Bottom!

The content for the lower row of buttons is driven by plain old posts; inside of WordPress they are named "Front Boxes". You can have up to 8, but 4 or 6 look better.

For each create a new Front Box. You can use long titles.

A featured image is optional; they will appear on the content overlay for the box.

The order of the front page boxes is via the post sidebar option in the box labeled "Front Box Properties" for... Order

Use numbers to indicate which ones should appear first, left to right. They do not need to successive numbers, e.g. 1,2,3,4. You will see this listed under "Box Order" when viewing "All Front Boxes" in the WordPress Dashboard.

Extra "Stuff" on Front Boxes

Look for a few more settings in Extra Dimension Stuff box below the post content. The text entered in Front Button Label will be what is used to diplay the link in the box on the front page. If left blank, the theme will use the text of the post title. The label allows you to use a longer title when the box opens up.

You can also enter and optional link applied to the featured image and a bottom button to go to a designated URL.

Enter under Go Button Destintion URL the web address the bottom button should link to. You can edit the label on the button as well (if left blank it will be Go) The Font Awesome Icon Button can be changed to anything available from Font Awesome.


The same buttons that are placed at the end of content based on the settings above can be added to any post via a shortcode:

   text="Hall of Fame" 

These are made by including in your post code like:


Note on Featured images

The featured images displayed for each post will be scaled down to fit a size with an aspect ratio of 480px wide and 200px high. Wordpress can never scale an uploaded image large than the original

The image you upload needs to be bigger than this in both dimensions It will be scaled and cropped to the center of the image. If you do not want to experience cropping, creating your image with the same aspect ratio (it can be larger, e.g. 960x400).

Suggested Plugins

  • Font Awesome 5 Menus used to add the icons to the social media links below the tag line
  • Fluid Video Embeds will make sure your auto embedded videos (and other content wordpress can embed by URL) are responsive sized to fill the column width
  • Easy Theme and Plugin Upgrades allows you to update the theme by uploading the zip file again as a new server (because wordpress does not provide this capability)
  • JetPack can add a number of capabilities, such as adding a contact form. If you do create a contact form, make sure you also add and activate Akismet because you will get spam
  • Regenerate Thumbnails If you change to this theme from another one, you should run this plug to re-generate previously uploaded images in the specific sizes used by the theme.

Features / History

  • v2.2 (Oct 2, 2021) Updated to match changes in CSS/JS of the original HTML5UP Dimension theme, including use of Font Awesome 5 icons
  • v2.0 (Feb 25, 2020) Better CSS for a responsive and even sized navigation menu.
  • v1.8 (Oct 12, 2018) Nag notices added to encourage use of FontAwesome 5 plugin, CSS tweak to fix mobile menus, segment base CSS from WordPress
  • v1.7 (Oct 12, 2018) Rebranded WordPress posts internally as "Front Boxes" to better reflect their purpose. A new template for single entries shows a Front Box opened on the home page.
  • v1.4 (Jan 3, 2018) Deprecated use of Customizer Social Icons plugin and re-wrote instructions to use Font-Awesome 4 Menus
  • v1.3 (Aug 21, 2017) Integration of Social Media Icons for the WordPress Customizer plugin to provide a front page display of icons / links for social media sites, new post meta data field option to store an optional short name for the button display, another field to customize the link button label, CSS updates for aligncenter, alignleft, alignright classes, edit links added to post display.
  • v1.2 (Jun 19, 2017) Added a page template to create longer content pieces
  • v1.1 (May 20, 2017) Added shortcodes for link buttons, display and show order in the posts view of Wordpress Editor
  • v1.0 (Feb 19, 2017) First release