PIA — Site Admin Guide
A reference for managing content on pialberta.org via the NationBuilder backend.
1Changing the Hero Image on a Page
Each page can display its own hero (banner) image at the top. The site is set up to look for a specific file attached to the page — it must be named exactly hero.jpg.
To replace or set a hero image:
- Navigate to the page in your NationBuilder control panel and open it for editing.
- Click the Files tab within the page editor.
- If a
hero.jpgalready exists, delete it first, then upload your new image — also namedhero.jpg. - If no
hero.jpgexists yet, simply upload your image and make sure it is namedhero.jpgbefore uploading. - Save the page. The new hero image will appear at the top of that page.
hero.jpg — lowercase, no spaces. Any other name will be ignored and no hero image will display.
Image recommendations:
- Use a high-resolution landscape-oriented image (at minimum 1400px wide).
- Keep the file size reasonable — aim for under 500 KB for fast load times. Tools like Squoosh can compress images without visible quality loss.
- The most important subject matter should be centred, as the image may be cropped on mobile screens.
2Homepage Featured Content Slider
The homepage features a rotating content slider that highlights key pages, campaigns, or announcements. Each slide is pulled from a featured page or blog post that has been set up to appear in the slider.
How to add or edit a slide:
- Open the page or post you want to feature in the slider.
- In the page settings, ensure it is marked as Featured (this controls whether it appears in the slider).
- Set an Excerpt or introductory text — this may be used as descriptive copy on the slide.
- Make sure the page has a Featured Image set — this becomes the slide's background or thumbnail image.
Headline and Subheading — custom formatting
The slider uses a custom layout where the headline text field supports both a main headline and a subheading on a single slide. These are separated by the pipe character:
| (pipe character), then your subheading.Example:
Fighting for Public Healthcare | Join us in the campaign to protect your coverageThe text before the
| will display as the large headline. The text after will display as the smaller subheading below it.
| is typically found above the backslash key on your keyboard (Shift + \).
3Adding Tags to Pages
Tags are central to how content is organized and displayed throughout the site. Many sections — campaigns, task forces, event listings — rely entirely on tags to know where to surface content. Getting tags right is important.
How to tag a page, post, or event:
- Open the item for editing in NationBuilder.
- Find the Tags field (typically in the sidebar or under the Settings tab, depending on the content type).
- Type the tag name exactly as required (see sections below for specific tag names) and select it, or create it if it doesn't exist yet.
- A page can have multiple tags — add all that apply.
- Save the page.
4Campaigns — Active & Archived
The Campaigns section of the site automatically lists campaign pages based on tags. There is no manual curation required — simply tag the page correctly and it will appear in the right list.
| Where you want it to appear | Required tag |
|---|---|
| Current / Active Campaigns listing | Active Campaign |
| Archived Campaigns listing | Archived Campaign |
Moving a campaign from Active to Archived:
- Open the campaign page for editing.
- Remove the
Active Campaigntag. - Add the
Archived Campaigntag. - Save. The page will automatically move from the current campaigns list to the archived list.
5Task Force Content (Education, Seniors, etc.)
Blog posts, events, and pages can be associated with a specific task force so they appear within that task force's section of the site. This is controlled entirely by tags.
Apply the relevant task force tag to any content item — blog post, media release, event, or page — that belongs to that group:
(Add additional task force tags here as your site grows.)
Education and Seniors.
6Events — Calgary, Edmonton & Rural
The site lists events under regional headings. To control which regional list an event appears under, apply the appropriate tag when creating or editing the event.
| Region listing | Required tag |
|---|---|
| Calgary events | Calgary Event |
| Edmonton events | Edmonton Event |
| Rural / other regions | Rural Event |
Combining event tags with task force tags:
Events can carry both a regional tag and a task force tag at the same time. For example, a Calgary event related to the Seniors task force would be tagged Calgary Event and Seniors — it will then show up in both the Calgary events listing and the Seniors task force section.
7Blog Content Types
The site has four distinct blog-style content streams. Each is managed as a separate blog within NationBuilder, so you publish to the right one by choosing the correct blog when creating a post — not just by tagging.
Blog (General)
General commentary, opinion pieces, and organizational updates that don't fit a more specific category. Publish new posts directly to the Blog section in NationBuilder.
- In NationBuilder, go to Communication → Blog (or the "Blog" blog).
- Click New Post.
- Write your content, add a featured image, set the publish date, and publish.
Media Releases
Official press releases issued by PI Alberta. These should be formatted formally with a dateline and contact information at the bottom.
- Go to the Media Releases blog in NationBuilder.
- Create a new post. Use the press release headline as the post title.
- Paste the full press release text into the body. Include the date and media contact details.
- Add a relevant featured image if available, then publish.
In the Media
Links to or summaries of external media coverage about PI Alberta or related issues (newspaper articles, TV segments, radio interviews, etc.).
- Go to the In the Media blog.
- Create a new post. Use the original article's headline (or a clear descriptive title) as the post title.
- In the body, include a brief summary or excerpt, the source name, and a link to the original article.
- Set a featured image (the outlet's logo or a relevant photo works well).
- Publish.
The Advocate
PI Alberta's newsletter/publication content. Issues or articles from The Advocate are published here for the web archive.
- Go to the The Advocate blog.
- Create a new post for each article or issue being published online.
- Include the full article content, relevant images, and the publication date.
- If linking to a PDF version of the full issue, insert a download link or button in the post body.
- Publish.
8General Tips & Best Practices
Text on images
Putting text directly onto images espeically hero images should always be avoided. Website are responsive meaning the resize accoring the the screen size they are being video on. Putting images directly onto images means the text will almost never be displayed correctly.
Always preview before publishing
NationBuilder has a preview function — use it to check that the hero image, formatting, and tags are working as expected before making a page live.
Consistent tag spelling
Tags only work when they match exactly what the site templates are looking for. Keep a note of the exact tags used on this site (as listed in this guide) and refer back to it whenever you add content. If you mistype a tag, the content simply won't appear where it should — there will be no error message.
Featured images vs. hero images
These are two different things. The Featured Image set within a post's settings is used for thumbnails, social sharing previews, and the homepage slider. The hero image (the full-width banner at the top of the page) is the hero.jpg uploaded in the page's Files tab. You may need to set both for a page to look right everywhere.
Unpublishing vs. deleting
If you need to temporarily remove a page or post from the site, unpublish it rather than deleting it. Deleting removes the content permanently; unpublishing hides it from the public while preserving it for future use.
SEO basics
For each page or post, fill in the Meta Description field (usually under the SEO or Settings tab). Keep it to 1–2 sentences summarizing the page content. This text appears in Google search results.
Need help?
If something on the site isn't displaying as expected after you've followed the steps in this guide, double-check tag spelling and capitalization first — that is the most common cause of content not appearing where it should.
Do you like this page?