Managing Users

The Users section of the administrator backend gives you visibility over every user's point balance and lets you make manual adjustments.

The Users List

Go to Components → UserPoints → Users to see all registered users who have a UserPoints record. The list shows each user's username, real name, point total, rank, and referral information.

You can search and filter by username or name. Click a column heading to sort.

User Synchronisation

The Sync toolbar button compares the Joomla user table with the UserPoints user table and creates missing UserPoints records for any Joomla users who do not yet have one. Run this after bulk-importing Joomla users or if you notice users who cannot access their account page.

Recalculate Points

The Recalculate toolbar button recomputes each user's total point balance from their activity records. Use this if you suspect a balance is out of sync with the activity log (for example, after manual database edits or after resolving a data issue).

Editing a User's Points

Click any user's name to open their record. From here you can:

• Add points — enter a positive number and save to credit the user.
• Remove points — enter a negative number and save to deduct from the user.
• Set the balance directly — enter the exact total you want the user to have.
• View recent activity — a summary of the user's recent transactions is shown at the bottom of the form.

Changes made here are recorded as a manual activity in the activity log, attributed to the administrator who made the change.

Setting Maximum Points

Go to Components → UserPoints → Max Points to set individual ceilings for specific users. This overrides the global Max Points Per User configuration setting for the selected user.

Use this to give premium users a higher cap, or to restrict a specific user to a lower maximum without changing the global setting.

Resetting Points

From Components → UserPoints → Users, select one or more users with the checkboxes and use the Reset toolbar button. This sets the selected users' point balances to zero and removes their activity records.

You can also reset all users at once using the Reset All function, subject to having the core.resetallpoints permission.

Purging Expired Points

Points awarded by rules with an expiry date accumulate in the activity log until they are purged. Go to Components → UserPoints → Users and use the Purge Expired toolbar button to remove all activity records whose expiry date has passed. The users' current balances are recalculated after the purge.

Schedule this operation periodically (for example, monthly) if you use time-limited point awards.

Exporting User Data

Export Active Users

Go to Components → UserPoints → Export and choose Active Users to download a CSV file of the top 50 users ranked by total points. The export includes user ID, name, username, current point total, and referral ID.

Export Email Addresses

Choose Email Addresses on the Export page to download a CSV of email addresses extracted from activity record data fields. This captures email addresses that were stored as activity data references (for example, from invitation-related activities).

Both exports require the appropriate permission (core.exportactiveusers or core.exportemails).

The Frontend Account View

Users access their own account via a Joomla menu item pointing to Components → UserPoints → Account. The account page shows:

• Current point total and formatted balance.
• Their rank and any medals earned.
• A history of recent point transactions.
• Tabs for inviting friends, gifting points, and (if configured) cashing out.

Administrators see the same page for their own account. To view another user's account, browse to their profile URL directly or click their username in the admin Users list.