Portal Community

Four Reward Action Types

Manual Point Award

Award a specific number of points to a publisher. Requires a reason. Awards over 500 pts require dual-admin approval.

Badge Grant

Grant any achievement badge to a publisher regardless of whether they met the milestone criteria. Used for special recognition.

Tier Promotion

Force-promote a publisher to a higher tier. Rationale required. Can skip tiers (Bronze → Gold directly) for exceptional contributors.

Bulk Rewards

Upload a CSV to award points to multiple publishers at once. All-or-nothing validation — any error aborts the entire batch.

Manual Point Award Form

FieldRequiredNotes
Publisher searchYesAutocomplete search by publisher name or slug
Points amountYes1 – 10,000 pts. Awards above 500 pts enter dual-approval queue.
ReasonYesFree text — shown to publisher in their reputation history as "Admin Award: [reason]"
Award categoryYesCommunity Contribution / Bug Report / Conference / Ecosystem Partner / Other
Notify publisherNoCheckbox — send an email notification to the publisher; defaults to checked

Dual-Admin Approval for Large Awards

Awards of more than 500 reputation points require a second admin to approve before points are credited. This prevents a single admin from unilaterally making large reputation changes that could distort the leaderboard.

1

Admin 1 Creates Award

Fills out the award form and submits. Award enters "Pending Approval" state — points are NOT yet credited.

2

Pending Approval Queue

The award appears in the rewards management "Pending Approval" tab. All other admins see it there.

3

Admin 2 Reviews

A second admin (cannot be the same admin who created the award) reviews and approves or rejects. A rejection requires a reason.

4

Points Credited

On approval, points are immediately credited to the publisher's reputation score. Both admins are recorded in the audit log.

Bulk Rewards CSV Format

publisherId,points,reason
acme-corp,250,Community talk at BizFirstAI Summit 2026
bright-solutions,100,High-quality bug report for InstallHub
river-tech,500,Featured integration partner contribution

The CSV is validated before any points are applied. If any row fails validation (invalid publisher ID, points out of range, missing reason), the entire batch is rejected and no points are credited.

All admin awards appear labeled in publisher history

Publishers see every admin award in their reputation history with the label "Admin Award" and the reason text. This transparency ensures publishers understand where their points came from and can verify the award is accurate.