---
title: Activities
url: 'https://manuals.remository.com/userpoints/activities'
markdown: 'https://manuals.remository.com/userpoints/activities.md'
date: '2026-10-06'
description: 'Every time a rule fires, UserPoints creates an activity record. The activity log is the authoritative record of all point transactions on your site. Viewing Activities Go to Components → UserPoints → Activities to browse the full log. Each record shows: The user who earned or spent points. The rul…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/06.activities/docs.md) 

# Activities

Every time a rule fires, UserPoints creates an **activity record**. The activity log is the authoritative record of all point transactions on your site.

## Viewing Activities

Go to **Components → UserPoints → Activities** to browse the full log. Each record shows:

- The user who earned or spent points.
- The rule that fired.
- The number of points awarded (positive) or deducted (negative).
- The date and time.
- The status (enabled/disabled, approved/unapproved).
- An optional key reference and data reference for traceability.

### Filtering

Use the search bar and filter dropdowns to narrow the list by user, rule, date range, or status. This is useful when investigating why a user has an unexpected balance.

### Approval workflow

If a rule has **Auto-Approved** turned off, new activity records for that rule are created with `approved = 0`. The points are not counted in the user's balance until an administrator approves the record. To approve records, select them in the list and click the **Approve** toolbar button.

---

## Activity States

Each activity record has two independent flags:

| Flag | Values | Meaning |
|---|---|---|
| Enabled | Yes / No | Whether the record is included in the user's point total. Disabling is non-destructive — the record stays in the log but the points are not counted. |
| Approved | Yes / No | Whether an administrator has reviewed and approved the award. Only relevant for rules where auto-approval is off. |

Toggling **Enabled** is the preferred way to temporarily remove points from a user's balance without deleting the record.

---

## Combining Activities

Over time the activity log can grow very large. The **Combine** operation merges many individual activity records for the same user and rule into a single summary record, reducing the number of rows while preserving the total point balance.

Go to **Components → UserPoints → Activities** and click **Combine** in the toolbar. Select the date range and rules to combine and confirm. This is a destructive operation — individual transaction details are lost — so run it only on historical data you no longer need to inspect individually.

---

## Archiving Activities

**Archive** moves older activity records to a separate archive table, keeping the main activity log fast for day-to-day queries. Archived records are still visible via the **Archive** view (**Components → UserPoints → Archive**) but are excluded from the live balance calculation.

Do not archive records that are still within the current earning period for any time-limited rules (for example, "once per month" rules), or users may earn points a second time for actions already recorded.

---

## Purging Expired Points

Points awarded by rules with an expiry date are not removed automatically. To remove them:

1. Go to **Components → UserPoints → Users**.
2. Click **Purge Expired** in the toolbar.

UserPoints deletes all activity records whose expiry date is in the past and then recalculates user balances. This is subject to having the `core.purgeexpiredpoints` permission.

---

## The Control Panel Activity Feed

The UserPoints control panel (**Components → UserPoints**) shows the most recent activities as a quick overview. The number of days included is controlled by the **Latest Activities Days** setting in [Configuration](https://manuals.remository.com/userpoints/configuration).

 [ ](https://manuals.remository.com/userpoints/managing-users) [](https://manuals.remository.com/userpoints/levels-ranks-medals)

---

## Navigation

- Previous: [Managing Users](https://manuals.remository.com/userpoints/managing-users.md)
- Next: [Levels, Ranks & Medals](https://manuals.remository.com/userpoints/levels-ranks-medals.md)