--- title: 'Managing Users' url: 'https://manuals.remository.com/userpoints/managing-users' markdown: 'https://manuals.remository.com/userpoints/managing-users.md' date: '2026-10-06' description: "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, po…" taxonomy: category: - docs --- [](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/05.managing-users/docs.md) # 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. Resetting is permanent. There is no undo. Take a database backup first if you may need to restore the data. 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. [ ](https://manuals.remository.com/userpoints/points-rules) [](https://manuals.remository.com/userpoints/activities) --- ## Navigation - Previous: [Points Rules](https://manuals.remository.com/userpoints/points-rules.md) - Next: [Activities](https://manuals.remository.com/userpoints/activities.md)