What are Leagues?

Leagues are points-based competitions. Leagues allow you to pit multiple users on OneUp against each other to compete on one or more metrics during the same competition (e.g., CVs sent, interviews arranged, permanent placements). As a result, Leagues are a great way to drive competition in your team and boost productivity.

There are two types of Leagues available on OneUp:

Individual Leagues
Individuals compete against other individuals.
Squad Leagues
Form squads and collaborate with your squad to compete against other squads.

ℹ️

Squads are teams formed during a competition.

Unlike regular OneUp teams that usually reflect your company's hierarchy and are used for data access rulesets, squads only exist during the competition itself and are created during competition set-up.

Creating a League

🚨

You must have the Manage Leagues permission in order to create/edit Leagues.

To set up a League:

Select Competitions in the main navigation menu and choose Leagues.
Select the + New button in the top right of your screen.
The League creation wizards appears. Enter your league details.
Name your League and set a duration for the league to run for.

♻️ Want to set up a recurring League? Check our guide here, then come back to this article to continue the setup.

🖼️ We recommend then uploading a custom logo for the League (optional).

💡 Working with teams across multiple timezones? When participants view a competition, they'll see the time in their local timezone. This is based on their system time, and not the timezone set in their individual profile settings.

When you're happy with the timeframe, type and logo, click Save and continue.
On the next page, select a league type on the select participants page.
There are two league types:
- Individuals
  In this league type, individual users will compete against each other.
- Squads
  Organize your participants into squads, so that the squads (two or more) can compete against each other. Add a custom image per squad if you like.
Select participants.
Whether you've selected 'individuals' or 'squads', select the participants you'd like included in your league. When you're happy with the participant configuration, click Save and continue.
On the last page, enter the league objectives.
These are the metrics/activities you'd like your users to compete on. Award points for each metric based on the importance you hold for each metric/activity in the League.
Finally, add incentives.
These are the prizes on offer for your winners.
Finally, launch your competition!

The league will appear in your active or upcoming leagues, dependent on the start date entered.

Viewing existing Leagues

Find all your existing Leagues under Competitions in the main navigation menu, and Leagues.
Search for a League by typing the League's name into the search bar on the right, or use one of our filters on the left to find the League you're looking for.
Select the League name, or the open button on the far right, to navigate to a specific League.
You'll be displayed with a breakdown of the League, listing the league standings.
Navigate to the Incentives & Objectives area, to find incentive details, as well as how the League standings are calculated.

Tips 💡

If you want to make use of a duration metric as a league objective, OneUp looks at duration in seconds. This means with the default of 1 point per activity, OneUp will award 1 point per second of duration logged.
If you want to customize this, for example to award 1 point per 5 minutes of duration, you'll need to apply the following formula to get the number of points:
- Work out the total number of seconds in your desired duration (in our example, 5 minutes = 60s x 5 = 300 seconds.
- Divide 1 point by 300 seconds to get the number of points needed so that 5 minutes equals 1 point. In this case 1 / 300 = 0.00333.
- Enter this value in the points box.

Troubleshooting ✨

Can't find a league?

Be sure to check the 'Upcoming', and 'Ended' areas too, found at the top of the page.

My league has incorrect data/missing points!

Check the date range of the league - points will only count if logged after the start date (8am default) and before the end date (6pm default). Especially when multiple timezones are involved, ensure the data that's missing is recorded against the date you expect. If you have access, checking the affected data on a report or dashboard is the recommended way to troubleshoot this.

Also check the league activities that count towards the objective - the objectives may have been incorrectly configured.

Wondering how to make changes to an existing league, or copy a league?

Visit our Managing Leagues article.

If you still require help on this topic, get in touch with our support team via the chat. We'll be happy to help! 💙

Get Started with Leagues