Badges (Definitions, Rules, and Awards)

Peer-to-Peer (P2P) Badges automatically recognize participants as they make progress in an activity tracking event (for example, First Mile, 10 Miles, Marathon). This article explains how admins manage Badge Definitions, Rules, and Awards.

Badges can be scoped to a specific Activity Type, and badge awards are intended to be permanent once issued.

Key concepts

Badge Definition (what the badge is)

A Badge Definition describes the badge itself and controls how it appears.

Common fields include:

Name (required)
Description (optional)
Icon (image or URL)
Active / Inactive
Sort Order (controls display order)
Activity Type (optional)
If set, badge progress is calculated only for that activity type.

Badge Rule (how the badge is earned)

A Badge Rule defines the conditions required to earn a badge.

Rules typically include:

Rule Type (required)
Active / Inactive status

Most P2P badges are earned when a participant’s total activity meets or exceeds a defined threshold (for example, total miles ≥ 10).

See Rule Types in detail here.

Activity Type scoping
If the badge definition includes an Activity Type, rule evaluation applies only to that activity. This prevents participants from earning activity-specific badges through unrelated activity types unless explicitly intended.

Badge Award (the record of earning a badge)

A Badge Award is the system record that a participant earned a badge.

Each award includes:

The participant (linked to their child fundraising campaign)
The date/time the badge was earned
Whether it was awarded automatically or by an admin

Managing badge definitions

Use badge definitions to configure which badges are available in a P2P campaign.

Common admin actions:

Create new badges
Edit badge details (name, icon, description)
Set badges as Active or Inactive
Reorder badges
(Optional) Assign an Activity Type

Recommendations

Use clear, consistent naming (for example, 5 Miles, 10 Miles, Half Marathon).
Keep descriptions short and participant-friendly.
Scope badges to an Activity Type when multiple activities exist to avoid confusion.

Managing badge rules

Badge rules control the “earned when” logic.

When creating or editing rules:

Select the appropriate Rule Type
Provide the required Rule Settings
Ensure the rule is Active

Rules are evaluated based on participant activity totals and event evaluation settings.

Badge awards: What admins should expect

How awards are issued

Badge awards are typically created automatically when:

Activity logs are added, imported, or synced
A participant meets the badge rule criteria
Real-time evaluation is enabled

When activity logs change

Activity totals and progress may update
Previously issued awards may be removed automatically

Badge template packs (optional)

The activity settings include Badge Template Packs, which include prebuilt badge definitions and rules.

Template packs may include:

A pack name and description
Multiple badges with predefined rules

Admins may have the option to import existing badges and rules when applying a template. Use this option with caution.

Admin best practices

Configure badges and rules before participants begin logging activity
Use Activity Type scoping for multi-activity events
Avoid deleting badges mid-event; set them to Inactive instead
If thresholds change mid-event, communicate clearly—existing awards may remain while future awards follow the updated rules