--- title: How to configure a leaderboard for various activities description: Learn how to configure and manage the leaderboard feature, allowing attendees to earn points for completing tasks during events. This guide covers enabling the leaderboard, setting up tasks, managing team scores, and customizing achievement popups. --- [Skip to content](https://help.vfairs.com/knowledge/how-to-configure-a-leaderboard-for-various-activities#main-content) English Show submenu for translations [Customer portal](https://support.vfairs.com/care?hsLang=en) Open main navigation Close main navigation - English Show submenu for translations - [Customer portal](https://support.vfairs.com/care) Welcome to vFairs Help Center - There are no suggestions because the search field is empty. 1. [Help Center](https://help.vfairs.com/knowledge?hsLang=en) 2. [Engagement](https://help.vfairs.com/knowledge/engagement?hsLang=en) # How to configure a leaderboard for various activities ## Learn how to configure and manage the leaderboard feature, allowing attendees to earn points for completing tasks during events. This guide covers enabling the leaderboard, setting up tasks, managing team scores, and customizing achievement popups. ### Enabling the Leaderboard To enable the leaderboard, follow these steps: 1. Navigate to **Event Setup**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcFjBA5GBHFZfiwxZnCrQdzzfKwES9zpuCjZBnfzoqKMTsmpU9PC6chIg-fh1Weub90y7393u8yiRvMyOvsemKn92daWjXxdIsFI84LQ4kdIG6mX7r3H0NPDQ9LunNKex2ebpibHaC-JbOsssB_-zInyIlk?key=pyUYbQFwERYAjcz9yXS0pA) 2. Under **Event Setup**, toggle on **‘Enable Leaderboard’** toggle present under **Addons**. ![](https://help.vfairs.com/hs-fs/hubfs/image-png-Feb-19-2026-01-34-56-3952-AM.png?width=1920&height=1032&name=image-png-Feb-19-2026-01-34-56-3952-AM.png) 3. Click **Update** to save the changes. ![](https://help.vfairs.com/hs-fs/hubfs/image-png-Feb-19-2026-01-36-33-7830-AM.png?width=364&height=150&name=image-png-Feb-19-2026-01-36-33-7830-AM.png) ### Leaderboard Settings and Preferences In **Event Setup** under **General Settings**, you can configure the following leaderboard preferences: #### Basic Settings - **Select Leaderboard User Role**: Choose the user roles that will participate in the leaderboard. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeB5wHtgOScz5Z0_uLrwJd_qlz8LutkOK4XF-VEI3m34Yu1AmhqtsU9EJg7cnsnDu8L4kCEr8I2Px2l90prw0X9ATuyfbEi2uxE7aEca51kMaMgGrkIywKnNX0Kmnxeq1K5ElnMg0hR-zmpJhLMmK2gMV_h?key=pyUYbQFwERYAjcz9yXS0pA) - **Show User Image in Leaderboard**: Toggle this on to display user images on the leaderboard points page. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcB2xIiibU2dMABRCdEK4fRLtOR2AXOE5WIb53YOvk2RV1SnJu7YVozjee2cW3SzIdmgw7U7FRCie3bN8UFj3ZeM6W8FvR-EprBi5NMMnXz5B_R5sUYz4eBQCCil4Pfi9X_LKNRZnhVeuPVQYn6aOpePF4t?key=pyUYbQFwERYAjcz9yXS0pA) - **Set Date Range**: Specify the period during which the leaderboard will be active for users. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfqoZB_zurQ4HjYNhJ4k4fYVQK3VkDxtAG_jvUEbTE2sWVBhIoWw1zEviZgihWBnJahbVKFGjLXEWS1kYMPVqVXm10uP7x6BrHQr_KkKtDAe-CuyOaV66B7gp8WlU3P3PpfyLt8_WAFLBzuhuqol5Vr1cQS?key=pyUYbQFwERYAjcz9yXS0pA) - **Top Users Display**: Choose how many top users you want to display on the leaderboard points page in the virtual platform or event mobile app. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcgoKXAVCgs7JM4YaRws9Bg--bxpXOzUIV2-ORSLlJgdit_pC59prPWAf3Ko-7lWwABBGKLpUJ1zPzoX3kFrobBQ6n71oEAGNPBWORhOs--r24nZ4cCF1RutnNNzTqp9VT2leuHjWtOsbjC0icY0hm0NeTJ?key=pyUYbQFwERYAjcz9yXS0pA) ### Leaderboard Achievement Popup Event organizers can enable achievement popups when attendees reach specific point milestones. To enable this feature: 1. Toggle on **‘Enable Leaderboard Achievement Popup’**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdilm41C2v8yG9wHSB2hkIQNbvTscF0V_QW-nlkexXHmlV1ENkGfER3s_T45aQfWcXhP6f1q1fI1nQlTebn6BQr7i5-utpxvVY36LIvWxIsIeHic7XXrgAQtVkAKYv0XUxubCbNYCP2-NkcgXcDitaa4JAH?key=pyUYbQFwERYAjcz9yXS0pA) 2. Set the **minimum number of points** required for the achievement popup to appear. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdxrJY-PKaKJUSMqurD2j05SIjgfLnf1jztyiIreXiWeh8QdCYO40wl2Zrqn1ZlmmQR8CkWWpM1sRfoQ-61AJJC__6eoOhtUEmZxlmSYDuhuoU9uoV9ZJoxqQsChFABG-NjyVxj0s7hr7V7KxVUHEzaVQ46?key=pyUYbQFwERYAjcz9yXS0pA) 3. To allow users to continue earning points after reaching the achievement milestone, toggle on **‘Keep Increasing Points After Achievement’**. This ensures ongoing competition for top positions on the leaderboard. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeKjbL5_wTK_yUYvHfcxamsGYC3D8evSuDR3DEe9ORB65ileMaUKbMhHe9H_Vw83Yax1pGYaKFQSwIbCBqEbtGOvfoUJ81st0ef8PxvG0CWN-LJI7g5-fU16nW-pIKd7OmCMv82tZVyOH1ttl1ni38apvHo?key=pyUYbQFwERYAjcz9yXS0pA) ### Creating a Custom Achievement Popup: 1. Navigate to **Event Content** from the left navigation menu, and select **Event Page Manager**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUc-Mb6nRQbaWEhVpObfUSFHSo11yoOJWhDwsD_pc9JeBdm7Zul0F4RtW7ekRhU0vcuQGERF0OQwpZDrdnR3FNs60fZldhq2FbtpDmUj4URQ7I17KrjofiPa7oLY6njZC3TuT22FCfp4Y4rRSQDQncVKM?key=pyUYbQFwERYAjcz9yXS0pA) 2. Click **+ Add** to create a new CMS page. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcV5Q3CHyO5R4HUrIuTcMBz9Vi_UAX3gDxNQbPxomja3PWwmW-eHoWjxX2cwaeB1Jwz10ZkMikobOiXBRIk49MMwZqGPOIz07EKpHRjxHCOEVTlNbJtDTBYeDgjgAVIkQK1HzdhUpqC_XOHi-jIZE5s6w8?key=pyUYbQFwERYAjcz9yXS0pA) 3. Enter a **page title** and select **Custom Page** as the type. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfHmwmvWTsdQJ-4f2-0AjzjlpD4NvAAsEOy9HDzktJnhc5YYPYmnoyWgbZe6Fr0XX9GzK0rSz_2Wr6biEZ-Mzo6s6Fn9DttcjiQtzpY6mpRO3H9O0sVtarHCjmD_3M1Iuw4fb0eHXgy5aX5bJIwcBYPXsW3?key=pyUYbQFwERYAjcz9yXS0pA) 4. Click **Save** to proceed. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXftcQKIsW8Hndqraahg8xAsS-DI7QJYr4K3Pnm2titftrfMEOdoTvQ1degHa9dqIvSSE5d098IoJjpmFy73Y8jgin7b6l8blz7deSbYg-unCBkeiA8vos_YFiNI3GOTaMbiAIKaQ2zJcGRHW55jYNFG8eQo?key=pyUYbQFwERYAjcz9yXS0pA) 5. Under **CMS Page Widgets**, click **+ Add**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXd3oE-C-H3xDV2eWpvJpAkywTgsZYD0KK6A0y9fd4MRGfGcyxv3L4zdS2OIlSfT2-Elxy0L7vroKkq8g4TPeDrepafiUMaLSokURPKxcMlfB9u12AvLZtmSZ1p8W8xqFf25vLs-kHsLOacqvRDdurLLppCg?key=pyUYbQFwERYAjcz9yXS0pA) 6. Add the desired content for the achievement popup in the content section and click **Save**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdRkQoeKEkQB2b3sIGs-YhkVBjnp2I9MZ7hWtYMF75qyypPHSvrj23R4gyMM5UU7k80Q6RBGXw6oBRNBjTBbLrBlBNhEEU5hMlVWo0bbwocigEiM-I_b_FLMeBfkdArl5bJX7l4zJAL2QOLzLlvROTj0iW_?key=pyUYbQFwERYAjcz9yXS0pA) 7. Go to **Event Setup → General Settings**, and select the newly created CMS page from the dropdown in the **Leaderboard Achievement Popup Page Selector**. This CMS page will be displayed in a popup when users reach the required points. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXd8n40YcTm7C9iyLXE54Uj9v2yY4m9NXJLLv-eXSleQgjD7MgCT579qJQO07c2u5fkiWFsiTGji38bW87ZgL7H6zXkxlLacJfxkFLzYOPrxqij0cO9nHfyeo2GhZs7hx6dS0ZXAGl0KitSsiqZgK-2S_XbP?key=pyUYbQFwERYAjcz9yXS0pA) ### Enabling and Setting Up the Team Leaderboard Users can be divided into teams, allowing team scores to be displayed on the leaderboard in the Virtual Platform or Event Mobile App. To set up the team leaderboard, follow these steps: 1. In the attendee registration form, create a **dropdown field** to assign users to teams. Ensure this field is set as mandatory. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdNcZvSMuaQWRY8_UH3ZqQxVOOg89vYO-Fi8L6lVygXoNhactA_7RVUAt04LWiYziCXILqLSU_TtylkDDFOnOs25TZYdcoqFy9nZV_xWMaakt6drFHt7dUSvboQlmCrMDMfosBfQCYVrpUwTcEeeFgutDc?key=pyUYbQFwERYAjcz9yXS0pA) ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXesNEHZ2V7uF8-43NVD61Tar34uU5zSIGlV3OkV8cI33Lj9z9mod7uz7PmaVXUpZ86_-JZ6Ce2BM2dFFsLpaq7TRrOukpzvGJE8w8BllrRWhZSJr6sDT3SsN_H8YcUH12_-MTZIgyNYYrV0LnQ1pHbCo4Yo?key=pyUYbQFwERYAjcz9yXS0pA) 2. Go to **Event Setup → General Settings** and toggle on **‘Enable Team Leaderboard’**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdGPzUbPM-sQLzYWT7iVHSx_kb3PPXPXW4jnitImcnqjiICtK2kVN6BGK1xliAZ627h2lTI4vX4tJAAeO7wY2RJoSMccxiydRHa5ZtesDpD9evpXqX85tgPu9BtXdwdh28DXDPT9rMk7f8F8_RkH_AbWx4q?key=pyUYbQFwERYAjcz9yXS0pA) 3. Select the **team field** created in the attendee registration form under **Team Field Mapping**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcw_MpidJzRMTrHc4Gte8a7BSgmAfEWOV1OMLEhU2Xn0xeK8PjIUcepVyr8GvuvFOs0Dd3Xy-DAzhyNm3batkA5qL1sysKBXhi6KY298ecDnuOoS_2GU2obmcGJe3wWRqFfJmg5PCMU3bMB7wntyj-1xYU?key=pyUYbQFwERYAjcz9yXS0pA) 4. Team scores will now be grouped by team names. The leaderboard points page will display the teams and can expand to show individual scores of top users in each team. ### Setting Up Leaderboard Tasks and Assigning Points Event organizers can create tasks and assign points for each completed task. Follow these steps to configure tasks and point allocation: 1. From the left navigation menu, go to **Engagement → Leaderboard Settings**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfBpjqY2aX9M0Z1BaTBgVnqEZBKiSDkiYLNApcKl4udAtisMavt5Lm7mORp5fwbJgrmDGL4QUgLAijvfIqzkSmpxVDiFrs-4jAQ1NvxeoFzg_1Y8itT5Fka4JPrtqEoiBm2-j6J8EnI_P19cQ6hqwS191kN?key=pyUYbQFwERYAjcz9yXS0pA) 2. Click **+ Add New**. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcWiYiwdj--9BDKJJuhpmcgKu79DZ_aiffx7hzd8hRZbxoBy254MQF4hocB2t7atasP4iQmtqifUMktN70zF0CbSEiknMaJwjxNOY8CUcLt4xLtfnc89XBSGvGU-DObqTYTLTTsVygjUTshaxQ9cjPdrHk?key=pyUYbQFwERYAjcz9yXS0pA) 3. A form will open with the following fields: 1. **Score:** Enter points that you wish the attendee receive after he performs the activity 2. **Max Score Limit:** Sets the maximum total points a user can earn from this activity, regardless of how many times it's completed. Leave blank for no limit. 3. **Language:** Select the language. Normally, it is your event language but if your event is in multiple languages, you can select different points for each language. 4. **Activity Type:** There are two types, Mobile and Web. You can select your audience based on the mobile or web application they will use for specific activities. Some activities are limited to mobile or web that is mentioned along with the activity name. 5. **Reference IDs:**  Reference IDs allow you to link specific activities to the points system. Based on the selected activity, you can associate one or more reference IDs to determine when points should be awarded. For example, if the activity is booth visit, you can assign reference IDs for specific booths. When a user visits those booths, the corresponding points will be awarded. ![](https://help.vfairs.com/hs-fs/hubfs/image-png-Sep-30-2025-09-58-33-9361-PM.png?width=398&height=468&name=image-png-Sep-30-2025-09-58-33-9361-PM.png) 4. Click **Save** to finalize the task.   - [Organization Management](https://help.vfairs.com/knowledge/organization-management?hsLang=en) - [Event Setup & Navigation](https://help.vfairs.com/knowledge/event-setup-navigation?hsLang=en#main-content) - [Document Library](https://help.vfairs.com/knowledge/event-setup-navigation?hsLang=en#document-library) - [Translations And Labels](https://help.vfairs.com/knowledge/event-setup-navigation?hsLang=en#translations-and-labels) - [Attendee Management](https://help.vfairs.com/knowledge/attendee-management?hsLang=en) - [Agenda Management](https://help.vfairs.com/knowledge/agenda-management?hsLang=en#main-content) - [Session Management](https://help.vfairs.com/knowledge/agenda-management?hsLang=en#session-management) - [Speaker Management](https://help.vfairs.com/knowledge/agenda-management?hsLang=en#speaker-management) - [Speaker Management](https://help.vfairs.com/knowledge/speaker-management?hsLang=en) - [Event Website & Landing Pages](https://help.vfairs.com/knowledge/event-website-landing-pages?hsLang=en#main-content) - [Web Page Management](https://help.vfairs.com/knowledge/event-website-landing-pages?hsLang=en#web-page-management) - [Registration & Ticketing](https://help.vfairs.com/knowledge/registration-ticketing?hsLang=en#main-content) - [Registration](https://help.vfairs.com/knowledge/registration-ticketing?hsLang=en#registration) - [Ticketing](https://help.vfairs.com/knowledge/registration-ticketing?hsLang=en#ticketing) - [Payments](https://help.vfairs.com/knowledge/registration-ticketing?hsLang=en#payments) - [Exhibitor Management](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#main-content) - [Booth Negotiation](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#booth-negotiation) - [Task Management](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#task-management) - [Booth Management](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#booth-management) - [Document / Video](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#document-video) - [Jobs](https://help.vfairs.com/knowledge/exhibitor-management?hsLang=en#jobs) - [Sponsor Management](https://help.vfairs.com/knowledge/sponsor-management?hsLang=en) - [Networking](https://help.vfairs.com/knowledge/networking?hsLang=en#main-content) - [Chat](https://help.vfairs.com/knowledge/networking?hsLang=en#chat) - [Chat Queue](https://help.vfairs.com/knowledge/networking?hsLang=en#chat-queue) - [Video Matchmaking](https://help.vfairs.com/knowledge/networking?hsLang=en#video-matchmaking) - [Reports](https://help.vfairs.com/knowledge/networking?hsLang=en#reports) - [Meeting](https://help.vfairs.com/knowledge/networking?hsLang=en#meeting) - [Engagement](https://help.vfairs.com/knowledge/engagement?hsLang=en#main-content) - [Certificate Management](https://help.vfairs.com/knowledge/engagement?hsLang=en#certificate-management) - [Scavenger Hunt](https://help.vfairs.com/knowledge/engagement?hsLang=en#scavenger-hunt) - [Notifications](https://help.vfairs.com/knowledge/engagement?hsLang=en#notifications) - [Survey](https://help.vfairs.com/knowledge/engagement?hsLang=en#survey) - [LeaderBoard](https://help.vfairs.com/knowledge/engagement?hsLang=en#leaderboard) - [Quiz](https://help.vfairs.com/knowledge/engagement?hsLang=en#quiz) - [Reports & Analytics](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#main-content) - [Registration and Ticketing](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#registration-and-ticketing) - [User Journey Tracker](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#user-journey-tracker) - [Post Event PDF Report](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#post-event-pdf-report) - [Survey](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#survey) - [Cross Event Report & Reporting 360](https://help.vfairs.com/knowledge/reports-analytics?hsLang=en#cross-event-report-reporting-360) - [Marketing](https://help.vfairs.com/knowledge/marketing?hsLang=en#main-content) - [Email Campaigns](https://help.vfairs.com/knowledge/marketing?hsLang=en#email-campaigns) - [System Emails](https://help.vfairs.com/knowledge/marketing?hsLang=en#system-emails) - [SMS Campaign](https://help.vfairs.com/knowledge/marketing?hsLang=en#sms-campaign) - [AI Assistant](https://help.vfairs.com/knowledge/marketing?hsLang=en#ai-assistant) - [Social Meta](https://help.vfairs.com/knowledge/marketing?hsLang=en#social-meta) - [Web Notifications](https://help.vfairs.com/knowledge/marketing?hsLang=en#web-notifications) - [Accommodation & Budget Management](https://help.vfairs.com/knowledge/accommodation-budget-management?hsLang=en#main-content) - [Accommodation](https://help.vfairs.com/knowledge/accommodation-budget-management?hsLang=en#accommodation) - [Attendee Mobile App](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#main-content) - [Event Assistant](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#event-assistant) - [Getting Started & App Access](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#getting-started-app-access) - [Build & Customize Your App](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#build-customize-your-app) - [Legacy App](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#legacy-app) - [Sessions & Event Content](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#sessions-event-content) - [Engagement & Networking](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#engagement-networking) - [Event Operations & Insights](https://help.vfairs.com/knowledge/attendee-mobile-app?hsLang=en#event-operations-insights) - [Lead Capture App](https://help.vfairs.com/knowledge/lead-capture-app?hsLang=en#main-content) - [Reporting 360](https://help.vfairs.com/knowledge/lead-capture-app?hsLang=en#reporting-360) - [Badge Printing & Check-in App](https://help.vfairs.com/knowledge/badge-printing-check-in-app?hsLang=en#main-content) - [Printers](https://help.vfairs.com/knowledge/badge-printing-check-in-app?hsLang=en#printers) - [Badge Design](https://help.vfairs.com/knowledge/badge-printing-check-in-app?hsLang=en#badge-design) - [Integrations](https://help.vfairs.com/knowledge/integrations?hsLang=en#main-content) - [Custom Workflow](https://help.vfairs.com/knowledge/integrations?hsLang=en#custom-workflow) - [E-commerce](https://help.vfairs.com/knowledge/e-commerce?hsLang=en#main-content) - [Product Management](https://help.vfairs.com/knowledge/e-commerce?hsLang=en#product-management) - [Allowance Negotiation](https://help.vfairs.com/knowledge/e-commerce?hsLang=en#allowance-negotiation) - [Venue Builder](https://help.vfairs.com/knowledge/venue-builder?hsLang=en) - [Abstract Management](https://help.vfairs.com/knowledge/abstract-management?hsLang=en) - [Group Meeting](https://help.vfairs.com/knowledge/group-meeting?hsLang=en) - [Exhibitor Portal](https://help.vfairs.com/knowledge/exhibitor-portal?hsLang=en#main-content) - [Booth](https://help.vfairs.com/knowledge/exhibitor-portal?hsLang=en#booth) - [Search Attendee](https://help.vfairs.com/knowledge/search-attendee?hsLang=en) - [Data Tags](https://help.vfairs.com/knowledge/data-tags?hsLang=en) - [Organization Website](https://help.vfairs.com/knowledge/organization-website?hsLang=en) - [AI Tools](https://help.vfairs.com/knowledge/ai-tools?hsLang=en) [![vfairs-logo-landscape-gradient-5 (3)-1](https://help.vfairs.com/hs-fs/hubfs/vfairs-logo-landscape-gradient-5%20(3)-1.webp?width=107&height=44&name=vfairs-logo-landscape-gradient-5%20(3)-1.webp "vfairs-logo-landscape-gradient-5 (3)-1")](http://vfairs.com) vfairs.com Help Center Copyright © 2026, vFairs LLC