Unity Package Registry Authentication

Prerequisites

• A pckgs.io access token. See Create an Access Token.
• The pckgs.io scoped registry already added to your project. See How to Install a Unity Package.

---

Step 1: Generate an Access Token

Create an access token at pckgs.io/access-tokens/create. Make sure to grant it read access to the organization whose packages you want to install. See Create an Access Token for full instructions.

Step 2: Configure .upmconfig.toml

Unity reads authentication credentials from a .upmconfig.toml file in your user home directory.

1. Locate or create the file:

   • Windows: %USERPROFILE%\.upmconfig.toml
   • macOS / Linux: ~/.upmconfig.toml

2. Add your credentials:

[npmAuth."https://unity.pckgs.io/<YOUR_ORG_NAME>"]  
token = "<YOUR_ACCESS_TOKEN>"
alwaysAuth = true

Replace <YOUR_ORG_NAME> with your organization’s slug and <YOUR_ACCESS_TOKEN> with the token you created.

3. Save the file and return to the Unity Editor. Private packages will now appear under My Registries → pckgs.io in the Package Manager.

For more details on Unity’s authentication format, see the official Scoped registry authentication docs.

---

Related

• How to Install Unity Package
• How to Publish Unity Package
• Create an Access Token

Need help? Contact us here or at [email protected].