Howllo Product guides
The Howllo field guide

Know where to click.
Know what happens next.

Follow practical, click-by-click guides for workspace owners and staff. Learn how to create boards, invite your team, moderate feedback, and show customers where to take part.

For tenant staff · 7702Howllo App

Create boards, invite teammates, choose your public look, and moderate your workspace.

For customers · 7703Howllo Web

Customers browse boards, submit ideas or bugs, vote, comment, and follow progress.

For platform operators · 7701Howllo Admin

Operate the Howllo service itself: manage tenants, platform settings, and audit activity.

01

Create your workspace

Your workspace represents one product or project. Its boards, staff, theme, and customer community belong together.

1
Open Howllo App and sign in as staff

Open your installation’s App URL. On the hosted demo this is app.howllo.dev. Use the sign-in method configured for that installation.

2
Create the workspace

On Your workspaces, enter your product or project name, then click Create workspace. Howllo creates a URL slug and makes you the owner. It starts with zero boards.

3
Open the workspace card

The card shows its URL slug, board count, and member count. Click the card to open Manage workspace.

Howllo App · Your workspaces
Your workspacesStaff invitations

Your workspaces

Open a workspace to manage its boards, or create a new one.

Northstar Product
/northstar · 0 boards · 1 member
Open workspace
Workspace ≠ one board. A workspace is the shared home for a project. Create separate boards inside it for feature requests, bug reports, discussions, or announcements.
02

Create and share boards

Use the Boards tab in Howllo App to shape the public feedback spaces inside this workspace.

1
Open the Boards tab

In Manage workspace, choose Boards. The left list shows boards already in the workspace.

2
Click Create board

Enter a board name, URL slug, description, and type. Choose whether it is private. Click Create board.

3
Set up the draft board

New boards start disabled. Select yours to set its description, appearance, categories, tags, posting rules, and public/private access. Click Save changes.

4
Enable and share

Turn on the board when it is ready, then click Open board or Copy public link. Disabling it later pauses its public URL without deleting posts.

Howllo mascot creating a board
Each board is created and published separately.
Manage workspace · Boards
StaffBoardsPublic siteUsersModeration

Your boards Create board

Public boards appear on your workspace site.

Feature requests
feature-requests · feature-requests
Open board ↗
Bug reports
bugs · bug-reports
Public
Slug becomes part of the public URL. Keep it short and readable, such as bugs or feature-requests.
03

Customize your public site

Choose which pages visitors see, then set your workspace’s name, logo, and colors.

1
Open Public site

In Manage workspace, select Public site.

2
Choose public pages and post approval

Turn Boards, Feed, and Roadmap on or off. Enable Approve every post before publishing if you want manual review. Otherwise, regular posts publish immediately and suspicious posts wait for review. Click Save settings.

3
Set appearance

Upload your public logo, pick an accent and page background, then click Save appearance. PNG, JPG, and WebP uploads up to 5 MB and 4096 × 4096 pixels are supported.

04

Invite your team

Staff members help run this workspace. Their roles apply to the whole workspace rather than to only one board.

1
Open Staff

In Manage workspace, select Staff. Under Invite a teammate, enter their email and choose admin or moderator.

2
Click Send invite

For local accounts, copy the one-time invitation code and share it privately. If your installation has a connected identity provider, the invite follows that provider’s acceptance flow.

3
Ask them to sign in and accept

The invitee opens Howllo App, signs in, and accepts or declines. You can check the result in Staff; acceptance alone does not give access to another workspace.

Howllo mascot handing over an invitation
Staff access begins only after the invite is accepted.
RoleTypical useWorkspace access
OwnerPerson responsible for the workspaceManage boards, staff, branding, sign-in, users, and moderation
AdminTrusted teammate managing the product boardManage workspace settings and boards
ModeratorTeammate reviewing incoming postsModeration queue
05

Review posts

Keep incoming ideas useful and the public boards readable.

1
Open Moderation

In the workspace manager, select Moderation. The queue shows posts waiting for approval and posts staff have hidden.

2
Review a post

Read its content and reason for review, then click Approve to publish or Reject to keep it private. Use Show to restore a post staff hid earlier.

06

Manage public users

Workspace staff can restrict a customer from participating across every board in this workspace.

1
Open Users

Choose Users in Manage workspace to see customers who have joined this workspace through its public boards.

2
Select the restriction and explain why

On the person’s row, choose Temporary suspension and a duration (1, 7, 30, or 90 days), or Ban until lifted. Enter a reason.

3
Click Apply

The restriction takes effect across this workspace’s boards. To restore access, click Lift restriction.

Workspace-wide action. A suspension or ban applies to all boards in the workspace, not just the board where the person first posted.
07

Connect an existing customer login (optional)

Customers can use Howllo accounts. If your product already has accounts, you can connect your own sign-in flow instead.

1
Open Sign-in (SSO)

Select Sign-in (SSO) in the workspace manager and click Enable SSO.

2
Use the workspace secret only on your server

Your backend signs a short-lived user token and exchanges it with Howllo to start a board session. Follow the code example in the SSO tab and the authentication docs.

Never put the workspace secret in browser code. Treat it like a password. Rotate it if it is exposed.
08

What customers see

Give customers the workspace link or a direct link to a board. The public site uses your workspace branding.

Howllo Web · your-product
RoadmapSign in

Boards

Choose where to post or read feedback.

Feature requests
Suggest an idea or vote on a request
View posts →
Bug reports
Report an issue for the team
View posts →

Boards

Open the workspace link, choose a board, and browse its posts.

Board feed

Read reports and ideas, search or filter posts, open a post for details, and add your own post with the board’s Share feedback action.

Roadmap

See posts the team has planned, started, or completed. The workspace owner can hide the roadmap in Public site.

Account and activity

Sign in to vote, comment, and follow updates. Use your account menu to edit your public profile or see your activity.

Typical customer journey

1
Open the workspace or board link

The workspace link opens the board directory; a direct board link opens that board.

2
Browse before signing in

Customers can read public feedback and the roadmap. Private boards require workspace membership.

3
Sign in to participate

Choose Sign in and use one of the methods enabled by that workspace.

4
Post, vote, and follow up

Open a board to submit a bug or idea, vote on existing requests, and check status changes later.

09

Create a customer account

The workspace chooses its customer sign-in methods. A fresh installation offers local accounts; Google or Microsoft can be enabled by the workspace owner.

1
Click Sign in on the public site

For a local account, choose a username and password. If Google or Microsoft is enabled, you can select that provider instead.

2
Save your recovery code if you use a password

Local registration shows one recovery code. Store it somewhere safe; external providers manage their own account recovery.

3
Return to the board

After signing in, you can post, vote, comment, and manage your public profile from the account menu.

10

Use Howllo Admin (platform operators)

This surface is for the operator of the Howllo service. Tenant staff should use Howllo App instead.

Howllo Admin can affect the whole installation. Give access only to trusted platform operators. It is separate from tenant owner and staff accounts.
MenuWhat it doesWhen to open it
DashboardSummary of platform activityCheck overall service status and activity
WorkspacesList and inspect tenant workspacesSupport an organization or investigate a workspace
PlatformGlobal platform configurationChange installation-wide settings
BoardsInspect boards across the platformOperator support and troubleshooting
Roadmap / ContentReview roadmap items and contentPlatform-level support or moderation
Tags / MembersManage platform taxonomies and member recordsMaintain shared platform data
IntegrationsInspect connected integrationsDiagnose provider or webhook setup
AuditReview recorded administrative eventsTrace who changed platform data
SettingsInstallation settingsConfigure the running Howllo instance

First-time platform sign-in

Open admin.howllo.dev. On a fresh installation, enter the server’s bootstrap key and set the admin password. After setup, sign in with that password. The bootstrap key belongs in the server environment; it is not a workspace invitation code.

↗

Keep learning

Use these links when you need more detail than the UI walkthroughs.

Self-host Howllo

Follow the visual setup guide from database to your first published board.

Open setup guide ↗