Documentation

​
​

Development

User Acquisition

Monetization

Industry

Leaderboards

Unity SDK

Admin API

Client API

Open Unity Dashboard

Leaderboards

LiveOps
​
​
Leaderboards
  • Overview
  • Get started
  • Concepts
  • Tutorials
    • Configuration
      • Using Unity Editor
      • Using the Unity Dashboard
      • Using the CLI
      • Using the REST API
    • Unity SDK tutorial
    • Unity SDK sample
    • Cloud Code samples
  • Reference
  • Privacy and consent
  1. Leaderboards
  3. Write configuration

Unity Gaming Services CLI

Deploy leaderboard configurations with the command-line interface.
Read time 2 minutes
Last updated 9 months ago
You can use the Unity Gaming Services CLI to interact with Leaderboard configurations. The CLI allows you to create, deploy, and manage Leaderboard configurations from the command line.

Prerequisites

For a deep dive into the CLI, follow the steps in the Unity Gaming Services CLI Get Started guide.
To follow this guide, you must first complete the following actions:
  1. Install the UGS CLI.
  2. Configure your Project ID and Environment as such:
    ugs config set project-id <your-project-id>

    ugs config set environment-name <your-environment-name>
  3. Configure a Service Account with the required roles for Leaderboards and environments management. Refer to Get Authenticated.

Using the CLI

Refer to the Leaderboards Command Line documentation for a full reference of all commands and options.
Note
The 
ugs leaderboards
command is also available as 
ugs lb
.

Deploy configurations

Run the 
new-file
command to create a configuration with default content locally:
ugs leaderboards new-file <file-name>
You can use the 
Deploy
command to promote your local configurations to the remote environment. The local configurations must be deployed to become available to the game client.
ugs deploy <path-to-configuration-file> <path-to-configuration-file>
ugs deploy <path-to-directory>

Retrieve configurations

To retrieve information about the deployed configurations, run the following command:
ugs leaderboards get <leaderboard-id>
You can also list all configurations currently deployed to Leaderboards by running the following command:
ugs leaderboards list
You can use the 
Fetch
command to retrieve multiple Leaderboards configurations from remote at once. The provided path is a directory where the configurations will be fetched to:
ugs fetch <path> --services leaderboards

Environment synchronization

You can move all your configurations from one environment and deploy them to another environment.
You can then fetch the configurations and deploy them to another environment by running the following commands:
ugs fetch <out-dir> --services leaderboards --environment-name <environment-name>
ugs deploy <in-dir> --services leaderboards --environment-name <environment-name>

Delete configuration

To delete an existing leaderboard, run the following command:
ugs leaderboards delete <leaderboard-id>
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Prerequisites

    • Using the CLI

      • Deploy configurations

      • Retrieve configurations

      • Environment synchronization

      • Delete configuration

Report a problem with this page