Documentation

Development

User Acquisition

Monetization

Industry

Remote Config

Unity SDK

Admin API

Client API

Remote Config

LiveOps
​
​
Remote Config
  • Overview
  • Get started
  • Concepts
  • Tutorials
    • Write configuration
    • Code integration
    • Configuring your project
    • Configure stateful Audiences
    • Upgrade Guide
  • Reference
  • Privacy and consent
  1. Introduction to Remote Config

Configuring your project for Unity Remote Config

Configure your project for Remote Config.
Read time 2 minutes
Last updated 7 months ago

Requirements

  • This version of Unity Remote Config Runtime requires Unity version 2020.2 or higher.
  • Set your Editor scripting runtime to .NET 4.X Equivalent (or above).
  • Set your API Compatibility Level to .NET 4.x.
  • Enable Unity Services for your project.
  • Install the Remote Config package (detailed below).
  • Set assembly definition references (detailed below).

Installing the Remote Config package

See documentation on packages for more information on working with packages in a project. These steps may vary depending on which version of the Unity Editor you’re using.

Verified release

  1. In the Unity Editor, select Window > Package Manager.
  2. From the Package Manager window, find Remote Config in the Packages List view and select it.
  3. In the Package Specific Detail view, select the version and install to import the package into your project.

Preview release

  1. In the Package Manager window, the Advanced button lets you toggle Show Preview Packages to display them in the Package List view.
  2. Follow the instructions for the Verified Release installation.

Beta customers

Upon receiving the Remote Config package from your account manager, follow these steps:
  1. Download and unzip the package.
  2. In the Unity Editor, select Window > Package Manager.
  3. In the Package Manager window, select Add (+) to open the Add package from disk... dialog.
  4. Locate the package.json file inside your unzipped copy of the Remote Config package.
  5. Select Open to import the package into your project.

Remote Config environments

To get started, create an environment and give it a name.
  1. Go to the Unity Dashboard.
  2. Select the corresponding project.
  3. Select Environments > Add environment.
  4. Enter a name for the environment and select Add.
Note
Environment names are immutable.
The first environment you create is set as the default environment. This is the environment which is requested unless otherwise specified by the client. You can assign the default environment to an EnvironmentID in the Unity Dashboard, or via the REST API.
Once you’ve configured your project, configure your rules and settings in the Unity Dashboard

Assembly Definition References

The Remote Config package depends on Unity's authentication and core services. These dependencies require a small amount of user code for proper configuration.
To use Remote Config, you will need to include the following references:
  • com.unity.remote-config-runtime
  • Unity.Services.Authentication
  • Unity.Services.Core
Prior to using Remote Config, you will then need to:
  • Initialize Unity Services 
    • UnityServices.InitializeAsync()
  • Authenticate with Unity Authentication 
    • AuthenticationService.Instance.SignInAnonymously()
      for anonymous authentication
    • AuthenticationService.Instance.SignInWithAppleAsync()
      for apple authentication
    • AuthenticationService.Instance.SignInWithFacebookAsync()
      for facebook authentication
    • AuthenticationService.Instance.SignInWithGoogleAsync()
      for google authentication
    • AuthenticationService.Instance.SignInWithSteamAsync()
      for steam authentication
    • AuthenticationService.Instance.SignInWithSessionTokenAsync()
      for authentication with an existing token
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

    • Requirements

    • Installing the Remote Config package

      • Verified release

      • Preview release

      • Beta customers

    • Remote Config environments

    • Assembly Definition References

Report a problem with this page
​
​