Help center

Bannershut field guide

The complete guide to safely creating, approving, publishing, and delivering website content with Bannershut.

User manual

Learn by workflow

Update the message. Protect the website.

Bannershut gives staff a guided publishing workspace while website code, builders, hosting, and administrator credentials stay protected.

Create content Developer reference

Bannershut

Create

Approve

Publish

Chapter 01

Start here

Choose the path that matches your job. Most contributors only need the first path; administrators set up the system and control what becomes public.

I create content

Create a draft, add media and dates, preview it, then submit it for review.

Publishing walkthrough

I review content

Check accuracy, destination zone, links, accessibility, and timing before approval.

Approval checklist

I connect websites

Define stable zones, embed the widget, and confirm published content on the live site.

Integration guide

First-day checklist

Accept your invitation and sign in

Confirm your organization and role

Tour Content, Media, and Zones

Create one practice draft

Chapter 02

Roles keep responsibility clear

Access follows the least-privilege principle. Contributors prepare work; trusted reviewers and administrators control public delivery.

Platform owner

Super Admin

Manage organizations, billing, analytics, settings, and suspensions.

Organization lead

Organization Admin

Manage users, zones, settings, approvals, publishing, and audit logs.

Trusted reviewer

Content Manager

Review and edit submissions, manage drafts, and upload media.

Staff or volunteer

Contributor

Create drafts, upload files, and submit work for approval.

Important: Contributors cannot publish directly, manage users, or change organization settings.

Chapter 03

From draft to live website

Every item moves through a visible lifecycle. Scheduling and expiration dates can control when approved content appears and disappears.

1Draft

2Submitted

3Approved

4Published

5Archived

Contributor walkthrough

1
Choose a content type
Open Create Content and select a banner, announcement, document, event, alert, image, video, live URL, or footer notice.
2
Complete the required fields
Use a clear title, concise public copy, a valid destination, and descriptive link text.
3
Add media and timing
Upload an approved file type, choose the target zone, and set publish or expiration dates when needed.
4
Preview and submit
Check spelling, crop, links, dates, and mobile readability. Save a draft or submit it for approval.

Reviewer checklist

Message is accurate, current, and appropriate for the public

Title is descriptive enough to serve as image alternative text, and links are understandable

Correct organization, content type, and website zone are selected

Start and expiration times match the campaign

Media opens correctly and contains no private information

Live website is checked after publishing

Chapter 04

Zones are safe website placeholders

A zone is a named destination on a connected site. Use lowercase snake_case keys and keep each key tied to one predictable visual location.

Zone keyLocationBest use

homepage_heroHomepage heroCampaign banner or primary message

announcement_barAnnouncement barShort, timely site-wide update

events_sectionEvents sectionUpcoming events and calls to action

documents_pageDocuments pagePDFs, policies, and downloads

livestream_sectionLivestream sectionVideo or livestream links

emergency_alertEmergency alertUrgent, high-priority notice

footer_noticeFooter noticeCompliance or persistent small print

Naming rule: never rename a zone that is already embedded on a website until the website embed is updated too.

Chapter 05

Connect almost any website

Use the JavaScript widget for site builders and CMS platforms. Custom React and Next.js applications can use the public API for full layout control.

WordPress

Add a Custom HTML block, paste the widget, then save and publish.

Hostinger

Add an HTML embed element in Website Builder, paste the widget, then publish the site.

Wix, Squarespace, Webflow

Use the platform's HTML/embed component and place it where the zone should render.

React or Next.js

Fetch the public zone endpoint and render the sanitized items using your site's components.

Widget embed

Recommended

<script
  src="https://www.bannershut.tech/widget.js"
  data-org="your-organization-slug"
  data-zone="homepage_hero"
  data-theme="light"
></script>

Before you call it complete

Published item existsOrganization slug matchesZone key matchesDesktop and mobile checked

Open the complete API reference

Chapter 06

A short security routine prevents big problems

Keep publishing access separate from website administration and review who can approve, publish, and manage users on a regular schedule.

Secure accounts

Use unique strong passwords and protect administrator email accounts with two-factor authentication.

Limit access

Give each person the least powerful role they need and remove dormant accounts.

Control uploads

Allow only needed formats such as PDF, DOCX, JPG, PNG, WebP, GIF, MP4, and WebM.

Review activity

Check audit logs after sensitive changes and investigate unexpected publishing activity.

Chapter 07

Troubleshoot from the content outward

Most delivery issues come from status, timing, or a mismatched organization slug or zone key. Check those before editing website code.

The widget is not showing+

Confirm the item is Published, not Draft or merely Approved

Confirm it has started and has not expired

Compare the embed's data-org and data-zone values

Disable content blockers and clear the website cache

Open the browser console and check for script errors

The API returns no items+

Confirm the organization is active

Confirm published content exists in that exact zone

Check spelling and capitalization in the slug and zone key

Verify scheduling and expiration dates

Request the single-zone endpoint directly in a browser

The wrong content appears+

Check the item's selected zone

Confirm the website does not reuse the same zone unintentionally

Archive outdated items

Check that cached content has refreshed

An upload or link fails+

Confirm the file type and size are allowed

Rename files with simple descriptive names

Check that external links include https://

Remove private or access-restricted source links

Still need help?

Record the page URL, organization slug, zone key, content status, and any visible error message before contacting your administrator.

View activity logs

Ready to publish with confidence?

Create a practice draft, submit it through the approval workflow, and verify it in a test zone before your first public campaign.

Create a draft Open pilot checklist