Unity "too many activations" returning a license in CI

A Unity seat has a limited number of concurrent activations. When CI activates on every run but never returns the license, the slots fill up and activation fails with "too many activations".

What this error means

Activation fails with a message about too many activations or no remaining seats, even though credentials are correct. It started passing and then began failing after many runs.

Error while activating: too many activations. Return a license before
activating again, or wait for one to expire.

Common causes

Licenses are activated but never returned

Each CI run consumes an activation slot. Without a return-license step, slots are never freed and the seat hits its limit.

Many parallel jobs share one seat

Matrix builds activating the same Personal seat concurrently exhaust the small activation allowance quickly.

How to fix it

Return the license at the end of the job

1. Add a step that runs -returnlicense after the build, even on failure.
2. Ensure it runs with if: always() so a failed build still frees the seat.
3. Confirm the seat count recovers in your Unity account.

- name: Return Unity license
  if: always()
  run: |
    unity-editor -batchmode -nographics -quit -returnlicense

Serialize activations for matrix builds

Avoid activating the same Personal seat in many parallel jobs; use a Pro seat or limit concurrency so slots are not all consumed at once.

How to prevent it

• Always pair activation with a return step using if: always().
• Avoid activating one Personal seat across many parallel jobs.
• Monitor remaining activations in the Unity account.

Related guides