Documentation


One of the great things about NationBuilder is that they’ve developed an extensive library of resources that you can use to learn how to effectively use the NationBuilder platform. NationBuilder also offers free online workshops that are a great way to get more familiar with their platform or refresh your NationBuilder skills. You can check out their library of resources and workshop schedule here: nationbuilder.com/support.


Your custom NationBuilder website & theme has been built to work with NationBuilder's page template system, which is designed to make it easy to add and manage many different types of pages to your website via your NationBuilder Control Panel. You can learn all about NationBuilder's website features here: http://nationbuilder.com/ht_website

There are a number of special considerations to keep in mind when working with your custom website & theme:

1) Your website & theme includes a number of enhanced custom features, including a bespoke homepage, an alternate "container" page layout for your basic page templates, and more. These features are describe in other sections of this guide.

2) Your theme requires a number of key pages to work properly. You can update and change the content on these pages as needed, but make sure that they don't get deleted and that the slug stays the same. Here's a list of the slugs for the key pages of your theme:

  • home
  • join
  • upcoming events
  • action_centre
  • news
  • online_resources
  • library
  • timeline

NationBuilder is rich with tools to help you build beautiful, robust, and interactive pages on your website. Every page includes a What You See Is What You Get (WYSIWYG) editor, making it easy to apply basic styling to your content with the click of a button. Click here to learn the basics of creating and editing pages on your website.

Adding images, video, and other media

NationBuilder's WYSIWYG editor makes is easy to add rich media like images, embedded videos, and more to your pages. Click here to read about how to add rich media to your pages

Advanced page editing

If you're familiar with HTML and CSS, NationBuilder also includes an HTML editing tool in the content WYSIWYG editing toolbar. Your theme was built using the Bootstrap 3 framework, which means that with a little bit of HTML and CSS know-how, you can easily create advanced layouts for your page content directly within NationBuilder's content editor. For example, you can create responsive columns, or add buttons to your page content, all using Bootstrap 3.

Need help?

Need help with adding or styling your content, or creating beautiful layouts? Get in touch with us!


Banner image

The banner image at the top of your homepage can be updated by uploading a new image file named "header-background.png" under the Website > UBCIC > Home > Files tab in your NationBuilder control panel. The recommended image dimensions are 1300px wide X 376px tall.

The overlay text that appears over top of the banner image can be edited using the Headline and Subheadline fields under the Website > UBCIC > Site settings > Basic tab in your NationBuilder Control Panel.

Featured content slider

The images in the featured content slider on your homepage can be edited under the Website > UBCIC > Home > Settings > Featured content sliders tab in your NationBuilder Control Panel. To make sure your website looks and works great, your homepage should always have at least one published featured content slider image. The recommended dimensions for featured content slider images on your homepage are 750px wide by 600px tall.

Latest from UBCIC

This section of your website will automatically display the latest posts from your blog, and the latest tweets from your twitter account.

You can set a custom thumbnail image for each blog post by uploading an image named "thumbnail.png" under the Files tab for your blog post in your NationBuilder Control Panel.


You can edit the content that appears below your logo in your website's footer using the "Footer" content settings found under Website > Site settings > Footer in your NationBuilder Control Panel.

The links in the Wayfinding and Take Action columns are controlled via page tags. Any page tagged with "wayfinding" will appear in the Wayfinding column, and any page tagged with "take action" will appear in the Take Action column. The links will always appear in the order that they were published (so you adjust the order they appear by adjusting the publish date).

The facebook and twitter links in the Connect column are automatically populated with links to the facebook and twitter accounts of your website's primary broadcaster.


Any top-level page on your website that has the "Include in top nav" option checked will show up in your website's primary navigation menu. Any subpage of a top-level page that has the "Include in top nav" option checked will also show up in the drop-down menus in your website's primary navigation menu. Items in the top nav can be reordered by going to Websites > Top nav in your control panel.

Any page on your website that has the "Include in supporter nav" option checked will show up in your website's sidebar navigation (which displays on any page that has the "show sidebar" option checked).


Your Historical Timeline page is a customized blog page, where each blog post is a point on the timeline.

The year for an entry on the timeline is set by the publish date of each blog post. The headline text for each entry on the timeline is set by the headline field for each post. The optional descriptive text for each entry on the timeline is set by the "Before the flip" content for a post.

If any of your timeline posts include content "after the flip", a Read more button will show up in the timeline entry for that post that users can click to read the full description.

The downloadable PDF version can be replaced by uploading a new file named "Historical_Timeline.pdf" under the Files tab for your Historical Timeline page in your NationBuilder Control Panel.


Your Action Centre page is a customized landing page designed to highlight all the different ways your supporters can get involved with UBCIC. Any page on your website tagged with "action centre" will show up as a tile on this page. You can set a custom thumbnail image for each action tile on this page by attaching an image named "action-thumbnail.jpg" to the page you're working on.

For example, if you want your Donate page to show up in your website's action centre, tag the donate page with "action centre", and attach a custom thumbnail image to the donate page that is named "action-thumbnail.jpg". Custom thumbnail images should be 360px X 360px.


Sometimes you may want to use the pages in your top-level navigation menu as "containers" to organize related subpages on your website. You may however not have a lot of meaningful content available for these "container" pages

Landing on an empty page can create a poor navigation experience for your viewers. To help make sure your viewers have a great and intuitive viewing experience, we've developed a special feature that allows you to turn these types of "container" pages into a directory of the subpages below it. Simply add the tag "container" to any basic page, and a list of all subpages will appear on that page in a tiled layout.

Each tile has a default background image that will be applied automatically, but you can also add custom thumbnail images for a subpage. To add a custom thumbnail image for a given subpage, upload an image that's 360px wide by 196px tall and named "thumbnail.jpg" to the subpage in question.


Events on your NationBuilder website are managed through Calendar and Event pages. You can read more about Calendar and Event pages by clicking the links below:

http://nationbuilder.com/how_to_calendar

http://nationbuilder.com/setting_up_an_event


First, check and make sure that the changes you've made are published. If you're still having trouble, you may need to clear your website's cache. From your NationBuilder Control Panel, navigate to Website > Site settings > Clear cache.



NationBuilder includes some great tools you can use to make sure your website is search engine friendly. You can read about optimizing your website for search engines here: nationbuilder.com/organic_search_ranking_optimization


NationBuilder includes some great tools that allow your supporters to share your website via their social networks. You can read about how to optimize each page on your website for social sharing here: nationbuilder.com/optimizing_your_content_for_social_media