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
Built to work with many of Bootstrap 4’s native components & utilities
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.
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
thumbnailto the Files tab for that blog post or event page. Note that it can be either a.jpgor.pngfile.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 | 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.
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 pagesitemap- 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 |
| 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 |
| 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:
Create a new Redirect page in your NationBuilder control panel.
Use one of the supported platform names (listed below) as the page name.
Enter the URL of your social media profile in the “URL to redirect to” field.
Tag the Redirect page with: footer social media icon
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.
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 colorreplace
$color-1: $primary;by$color-1:#[chosenhexcode2];to change color 1and 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:
Go to your NationBuilder control panel and navigate to: Website → Site settings → Language
Select your preferred language from the dropdown
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.
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.























