Forem Admin Documentation
website·Indexed 36 days ago
https://admin.forem.com/Administrative guides for Forem, covering community management, user roles, and advanced customization. Includes documentation on configuring emails, campaigns, newsletters via Mailchimp, monetization, rate limits, anti-spam settings, and brand identity.
What's inside Forem
- HTML Variants are custom HTML and CSS designs used to inject specific layouts into different areas of the Forem platform. They are most commonly used for homepage banner designs. Variants can be filtered by their status or location, including Leaderboard (published & approved), Mine, Admin (all), Article show below article CTA, Badge Landing Page (/badge), and Campaign (homepage banner).
Overview of Forem Billboards
Billboards are customizable images, text, and links that appear in the upper right and lower left sidebars of a community homepage. They are managed via the/admin/customization/billboardsadmin page, where you can track attributes such as Organization ID, placement area, body markdown, published/approved status, and click-through success rate.Overview of Forem Campaigns
Campaigns are used to highlight information to an audience via the Forem Admin interface (accessible at/admin/customization/config). They typically consist of three optional features that can be enabled individually or simultaneously: a large banner on the homepage, highlighted articles under specific tags in the righthand sidebar, and a campaign image in the righthand sidebar.Overview of Tag Moderator privileges
Tag moderators are trusted users granted additional privileges to manage specific tags across a Forem community. They possess all standard trusted user features plus the ability to modify assigned tags on posts and edit the associated tag pages. As a result of their role, their profiles are featured on the tag pages they moderate.Overview of Forem Listings
Listings act as a community marketplace where users can offer services, share events, or sell items. Publishing a listing requires credits, which users can obtain via Badges or by purchasing them through Stripe's API (configured in Monetization Settings).Overview of Forem Organization accounts
Organization accounts are free for teams, companies, or clubs to participate on a Forem community as an identifiable group. Key features include:
- Dedicated landing pages for key information and member lists.
- Organization branding in the header and sidebar of published posts.
- Call-to-action (CTA) units alongside branded posts to drive traffic to products/services.
- Content management allowing admins to change post authors and publish under the organization.
- Enhanced analytics for view counts, reactions, and CTA clicks.
- Following system: members who follow an organization receive notifications for new posts and see content more prominently in their feed.
Create a custom navigation link in Forem Admin
To add a new navigation link, click the Add Navigation Link button in the admin panel and configure the following fields:
- Name: The user-facing label for the link.
- URL: The destination path (e.g.,
/faq,/about). - Icon: An SVG code snippet. Icons are displayed in a 24x24 px box.
- Section: Choose between
DefaultorOtherto determine where the link appears in the sidebar. - Position: An optional numeric value to define the sort order. If left blank, links are ordered descending by name.
- Display only when signed in: A toggle to restrict the link's visibility to authenticated users.
Moderate recently published articles
The 'Latest Articles' section provides a quick overview of the most recent publications. A toggle menu provides direct links to:
- Mod: Article Moderation
- admin: Article Admin
- Profile: Author profile page
- admin User: Author admin page (basic actions)
- Destructive Actions: Author admin page (destructive actions)
Manage member details using Member Management tabs
The Member Management page is organized into tabs that provide specific tools and data for each user:
- Overview: View and manage member roles, organizations, credits, and tag moderation. Use the Add role button to assign roles (e.g., Trusted Status) or suspend a user.
- Notes: A private area for Admins to record internal notes about a member's interactions or history.
- Emails: Used to verify email addresses, send emails, and review communication history.
- Reports: View all reports submitted by the member.
- Flags: View flags submitted about the user by moderators.
Manage static Pages in Forem Admin
Pages are used to store static content on a Forem instance that does not appear in Feeds. They support custom formatting and can be assigned top-level paths. You can manage pages (create new ones or view existing ones) by navigating to/admin/customization/pagesin the Forem Admin dashboard.Understand the purpose of Forem Admin documentation
The Forem Admin documentation is designed for users who have already launched and are currently managing a Forem community. It provides guidance on customizing the community appearance, utilizing moderation tools to maintain community health, and leveraging various features to enhance the user experience.Integrate Forem Newsletters with Mailchimp
Forem allows you to sync your community members with Mailchimp audiences. Newsletters are managed and sent entirely within Mailchimp; Forem uses the Mailchimp API to share the subscribers list. This is distinct from Forem's internal Email Digests. It is recommended to send no more than one newsletter per week.