Skip to main content

Raise theme guidelines

This guide explains how to configure, customize, and extend the Raise theme in NationBuilder.

Updated over 2 weeks ago

Use this guide if you want to:

  • Set up navigation and homepage layout

  • Upload correctly sized images and logos

  • Enable theme features using tags

  • Customize colors, fonts, or buttons

  • Decide when you need a custom theme

A fresh, functional, versatile, and mobile-friendly theme built on Bootstrap 4. Use it for your organization’s flagship website, a single-page microsite, and everything in between. View the demo site.

If you are using a custom theme based on the previous version of this theme, you can find some documentation here.

Features

  • Fully responsive, and designed to look and work great on devices of all sizes. Compatible with Google Fonts.

  • Create an engaging homepage with full-width, modular homepage sections and featured content sliders

  • Action forms included in sidebars for petition pages, endorsement pages, signup pages, and more

  • Fixed navigation menu that stays with you as you scroll

  • More intuitive UI design for nearby event search, user generated events, suggestion box pages, and more

  • New profile card design for directory pages, leaderboard pages, public profiles, and more

  • New expanding & collapsing accordion design for FAQ pages


Images and sizing

Logo

  • Ideal logo is horizontal

  • No small print

  • Ideal size 250 x 150px

You can change the logo size using page tags, see Changing the logo size using page tags section below.

Featured content sliders

Featured Content Sliders are a versatile way to showcase pages, campaigns, or key messages using large, visually engaging imagery and optional overlay text or buttons. These sliders are fully responsive and will adapt to different screen sizes.

Default mode (background image)

By default, each slide in a Featured Content Slider uses the uploaded image as a background image. This ensures the slider always fills the full width of the screen and scales smoothly across devices.

However, because background images are automatically resized and cropped to fill the available space, some parts of your image may not always be visible, particularly on smaller screens or devices with wider aspect ratios.

Pro Tip: Avoid using images that contain important text or faces near the edges. Instead, use the “Headline / Action text” field to display overlay text on top of your image.

  • Recommended dimensions: 1440px wide × 500px tall

  • Overlay text and optional button:

    • Text entered in the “Headline / Action text” field will appear as overlay text.

    • Any text entered after a “|” (pipe character) will be used as the button text.

  • Click behavior:

    • If the “Page to feature” points to the same page as the slider, the slide will not be clickable.

    • If it points to a different page, the slide will be clickable.

  • Homepage usage:

    • On pages tagged with homepage, the slider appears above the first content section.

    • If no content exists on that page, the slider will appear on its own.

Hero slider mode (Full image display)

You can optionally enable Hero Slider Mode, which displays the entire image at its original aspect ratio on all screen sizes.

This mode ensures that your full image is always visible — no cropping occurs — making it ideal for photography or artwork where the full composition is important.

To enable Hero Slider Mode, simply tag the page with: include hero slider

When this tag is present:

  • The first slide in the given Featured Content Slider will display the full-width image rather than using it as a background.

  • If multiple images are included in the slider, the first image’s dimensions will determine the aspect ratio for all slides, maintaining visual consistency. You can drag and drop the features content sliders to re-order them.

  • The “Headline / Action text” field will be used as alt text for accessibility purposes instead of overlay text.

Recommended usage:

  • Use high-quality landscape-oriented images that work well at a variety of screen widths.

  • Avoid using very tall portrait images, as they will result in extra vertical scrolling.

  • If including multiple slides, make sure all images used have the same dimensions.

Default mode

Hero slider mode

Homepage background image

  • The background image for the first section of the homepage pulls the image uploaded to Site settings > Background image

  • Recommended minimum width for this image is 1440px wide

  • Recommended height will vary, as the height of the first section of your homepage will depend on the content added to it.

  • Note an overlay will automatically be added to your image to help ensure any overlay text is legible.

Header image for other pages

  • The background image for the header section of other pages on your site pulls the image uploaded to Site settings > Header image

  • Recommended dimensions for this image are 1440px wide by 250px tall

  • Note an overlay will automatically be added to your image to help ensure any overlay text is legible.

Blog post & event card background image

  • Add a custom background image to blog post and event cards by uploading an image with the name thumbnail to the Files tab for that blog post or event page. Note that it can be either a .jpg or .png file.

  • Recommended image dimensions are 700px wide by 920px tall

  • If no thumbnail image is uploaded, the page thumbnail image uploaded under the Settings > Social media tab will be used instead. Note that this is also the image that will appear in the page preview when shared on Facebook & Twitter

Recap:

Image type

Where it appears

Recommended dimensions

Logo

Top navigation bar

250 × 150 px

Featured Content Slider (Default mode)

Full-width slider on homepage or pages

1440 × 500 px

Featured Content Slider (Hero mode)

Full-width slider (full image visible)

Landscape images, consistent dimensions

Homepage background image

First section of homepage

Min 1440 px wide

Header image
(other pages)

Page header background

1440 × 250 px

Blog post & event card thumbnail

Blog & event cards, social previews

700 × 920 px


Navigation for this theme

Top nav & sticky navigation

The Top Nav is your website’s main navigation menu that appears at the top of every page.

By default, the Top Nav in the Raise theme is sticky (i.e., it’s a “sticky nav”), meaning it remains visible at the top of the screen as users scroll down the page. This ensures your key navigation links and calls-to-action (like Donate or Sign Up buttons) are always accessible, improving usability and engagement — especially on longer pages or mobile devices.

Disabling the sticky nav on individual pages

You can disable the sticky navigation bar on specific pages by tagging that page with: disable sticky nav

When this tag is applied, the navigation bar will remain in a fixed position at the top of the page (non-sticky) and will no longer follow users as they scroll.

Disabling the sticky nav site-wide

If you prefer to disable the sticky nav across your entire site, you can do so by tagging your homepage with: site: disable sticky nav

When this tag is applied, the sticky navigation feature will be turned off globally for all pages on your site.

Supporter navigation (supporter nav)

  • To view the supporter nav, a user must be logged in. When they are logged in, clicking the profile icon in the top right corner of the nav menu will display the supporter nav.

  • Any page with the “Include in supporter nav” option checked will show up as a button in the supporter nav.

  • The user’s profile image, social capital score, and point person will also display in the supporter nav, as well as links to their public profile (if enabled), account settings page, and a link to log out

  • Note that the three site buttons found under Supporter nav > Buttons are not used in this theme.

Page sidebars

  • When the sidebar is turned on for these page types, the form will appear in the sidebar, otherwise the form appears below the main body of content: Petition, Signup, Endorsement, Volunteer Signup, and Event. Page sidebars are only available for these page types.

  • Turning the page sidebar on or off for other page types will not change the layout.

Sidebar on

Sidebar off


Website page tags for this theme

Tag any page with any of these tags to enable/disable the described feature:

  • homepage - adds the tagged page as a modular section on the homepage.

  • nav button - Will turn top nav link into a button and move it to the far right. Note “include in top nav” must still be checked.

  • hide like page - hides the social sharing options at the bottom of the page

  • sitemap - adds a sitemap to the page. Works on basic pages only

Changing the logo size using page tags

By default, the Raise theme is optimized for logos with a landscape or wide rectangular aspect ratio, which tend to display best in the website’s Top Nav.

However, if your logo is square, vertical, or highly detailed, the default logo size may not provide enough space for it to display clearly. You can increase the logo’s display size using page tags, or set custom maximum width and height values with some basic theme edits (see Advanced Logo Size Editability section below for more on this option).

To switch between the default and either of the alternate preset logo sizes, tag your homepage with either site: navbar logo medium or site: navbar logo large.

Each size option increases the logo’s maximum width and height within the Top Nav.

Size

Homepage Tag

Recommended For

Small (default)

None

Best for horizontal or wide rectangular logos with simple, bold designs. Keeps the navigation bar compact and balanced on all devices.

Medium

site: navbar logo medium

Recommended for logos with moderate detail or taller proportions, such as stacked text or emblem-style marks. Provides greater visibility without overwhelming the navigation layout.

Large

site: navbar logo large

Ideal for logos that are highly detailed, contain fine text, or have a square or vertical shape that benefits from additional space.

When using larger logo options, note that increasing the logo height will also increase the overall height of your site’s navigation bar.

Footer social media icons

The Raise theme includes a flexible, page + tag based system for adding social media icons to your website’s footer. This approach makes it easy to manage your footer links directly from the NationBuilder control panel.

To add a social media icon to your website’s footer:

  1. Create a new Redirect page in your NationBuilder control panel.

  2. Use one of the supported platform names (listed below) as the page name.

  3. Enter the URL of your social media profile in the “URL to redirect to” field.

  4. Tag the Redirect page with: footer social media icon

  5. Publish the Redirect page

The icon for that platform will automatically appear in your site’s footer, linking to the URL entered in the redirect page’s Redirect to field.

The following platform names are supported and will display the appropriate icon when used as the page name:

  • Facebook

  • Instagram

  • X

  • Linkedin

  • YouTube

  • WhatsApp

  • Telegram

  • TikTok

  • Bluesky

  • Threads

  • Signal

Additional Details:

  • The order of social media icons in the footer is determined by the published date of each redirect page (oldest first).

  • Each icon will only appear if the redirect page is published.

  • You can update or remove a platform’s icon at any time by editing or unpublishing its corresponding redirect page.

Split Address Fields

By default, the Raise theme uses NationBuilder’s single-line address field. When the address field option is enabled for a given action page (e.g. Signup pages, Petition pages, etc.), users can enter their full address into a single input field, and NationBuilder will automatically parse that data into the appropriate fields of the user’s User Submitted Address on their profile.

If you are located outside of the USA, you should follow these instructions to split the default single address field into separate fields. Simply tag that page with: include split address fields. When this tag is applied, the default single-line address field will be replaced by the following separate fields: Address Line 1, Address Line 2, City, State / Province, Postal Code, Country.

Default fields

Split fields

All data captured via these split address fields will be stored in the user’s Home Address fields on their profile.

Supported page types include:

  • Signup

  • Event

  • Petition

  • Feedback

  • Survey

  • Volunteer Signup

  • Endorsement

  • Vote Pledge

  • Moneybomb

Additional notes:

  • When address fields are required on a given page and split address fields are enabled, the Address Line 2 input field will always remain optional.

  • Donation pages always use split address fields by default.


Advanced customizations

When to create a custom theme

You need a custom theme if you want to:

  • Custom colors — Adjusting your site’s color palette using the new annotated SCSS file, with guidance on how each color is used throughout the theme.

  • Changing your website fonts — Changing your site’s heading and body fonts using a series of pre-loaded Google Fonts options.

  • Advanced Logo Size Editability — Setting custom maximum width and height values for your Top Nav logo beyond the preset small, medium, and large options (see above).

You don’t need one for:

  • Navigation changes

  • Footer icons

  • Homepage layout

Note: We recommend creating a custom theme only if you’re comfortable making light edits to code, and have some understanding of HTML, CSS, SCSS, and Liquid.

How to create a custom theme

  • In your NationBuilder control panel, go to Websites > Your Website > Theme > New custom theme

  • Make sure the stock Raise theme is your website’s current theme

  • Click the “New custom theme” button

  • Give your new theme a name (e.g., “Raise – Custom”)

  • Make sure the “Clone your current theme (Raise)” option is selected

  • Click “Create Theme.”

For more on creating and cloning themes, see Create a website theme with NationBuilder.

Color editability

The updated Raise theme includes a new annotated SCSS file that makes it easy to update your site’s color palette without needing to understand advanced CSS.

How to customize your website’s color palette

  • In your NationBuilder control panel, navigate to Websites → Your Website → Theme → Current custom theme → Files

  • Open _theme-colors.scss

  • Editing the hex codes for the four color variables found at the top (see lines 2 through 5):

    • replace $primary: $primary; by $primary: #[chosenhexcode1]; to change the primary color

    • replace $color-1: $primary; by $color-1:#[chosenhexcode2]; to change color 1

    • and so on...

  • Click Save and publish changes

The four adjustable color settings used throughout the Raise theme are:

Theme color

Description

Example use

Default value

$primary

Main accent color for the website.

Buttons

#DE2F1B

$color-1

Secondary accent color

"Donate" button in the Top Nav. By default, this is set to be the same as $primary.

#DE2F1B (same as $primary)

$color-2

Tertiary accent color

Links, Top Nav hover color.

#1E78A9

$color-3

Main dark color

Body copy, background for footer and alternating homepage excerpt sections

#03354F

After updating your color values, click Save and publish changes to apply them to your site.

Additional Tips:

  • Ensure the colors chosen meet minimum contrast ratios for accessibility. You can test your palette using tools like https://webaim.org/resources/contrastchecker/. Combinations to test include:

    • White (#ffffff) foreground with theme primary color background

    • White (#ffffff) foreground with theme color-1 background

    • Theme color-2 foreground with white (#ffffff) background

    • Theme color-2 foreground with default light background (#f8f9fa)

    • Theme color-2 foreground with theme color-3 background

    • Default muted text color foreground (#6b737b) with theme color-3 background

Font editability

The Raise theme includes a set of pre-loaded Google Fonts that you can set as the Heading and Body fonts by making some minor edits to the _theme-fonts.scss theme file.

Included fonts:

  • "Lato" - Sans-serif; clean and modern, great for body text

  • "Montserrat" - Sans-serif; strong and geometric, perfect for headings

  • "Roboto" - Sans-serif; Google's signature font, very readable

  • "Open Sans" - Sans-serif; friendly and neutral, works everywhere

  • "Raleway" - Sans-serif; elegant with thin weight options

  • "Poppins" - Sans-serif; rounded and approachable

  • "Merriweather" - Serif; designed for readability, great for body text

  • "Playfair Display" - Serif; elegant and sophisticated, beautiful for headings

  • "Lora" - Serif; contemporary with calligraphic roots

  • "Source Serif Pro" - Serif; professional and readable

How to change your fonts

  • In your NationBuilder control panel, navigate to Websites > Your Website > Theme > Current custom theme > Files

  • Open _theme-fonts.scss.

  • Replace the values of $theme-font-body and/or $theme-font-heading with any of the names above (see lines 72 & 73)

  • Save and publish changes.

Advanced Logo Size Editability

Depending on your logo, the space available might make your logo too small. You can make a couple of edits to allow more space in this area. Please note that making this space larger will increase the size of your top navigation, making the logo space too large the Top Navigation tiles and Donate button will appear too small.

Ideal logo specifications:

  • Horizontal logo

  • No small print

  • Ideal size 250 x 150px

To make the change, sign in to your nation's control panel and click Websites > Theme > Files > variables.scss, scroll to line 704 & 705

For most logos, a good size for width is 17rem, and for height, 6 or 7rem. If the logo has small lettering included, you can try 20rem width and 8rem height.

Note: The Larger this logo is made, the more the Top Nav will expand. If it is too large, the Top Nav page titles and the Donate-button appear too small, and it doesn’t look great.

If you need help, please reach out to [email protected]. Note that our Support team may recommend you work with one of our ecosystem partners if the customizations you are trying to make are outside of the scope of the technical advice they can provide.


Language support

The Raise theme now includes built-in multi-language support for:

  • English (default)

  • French

  • Spanish

To change your site’s language:

  1. Go to your NationBuilder control panel and navigate to: Website → Site settings → Language

  2. Select your preferred language from the dropdown

  3. Click Save settings.

Once updated, all theme-level text, such as button labels, form instructions, and other interface elements, will automatically appear in the selected language.

Signup form in French

Signup form in Spanish

Things to remember:

  • Changing your website’s language updates the language for theme elements only. It does not automatically translate existing content, page content, social sharing text, autoresponse emails, or other custom text. Make sure to review all pages and elements on your site and update content as needed.

  • When creating new pages, any default content (such as social sharing text or autoresponse messages) will still be generated in English by default. Be sure to review and update these elements manually as needed.


Raise + Website accessibility

The updated Raise theme includes a series of enhancements to improve accessibility. However, how you add and manage content on pages throughout your website remains a key factor in the overall accessibility of your site.

For guidance on creating accessible content and ensuring your NationBuilder pages meet accessibility best practices, check out this article: Building an Inclusive Digital Presence.


Did this answer your question?