Azure Pipelines Variable Group Not Authorized

By Kaveh Alemi·Latchkey

The pipeline referenced a variable group it is not allowed to use. The group exists but has not been authorized for this pipeline, or the name/ID is wrong - so the reference cannot resolve.

What this error means

The run fails at compile/start with Variable group <name> could not be found or is not authorized for use by this pipeline. The variables it should provide are unavailable, so dependent steps fail.

##[error]Variable group 'prod-secrets' could not be found or is not
authorized for use by this pipeline.

Common causes

Group not authorized for the pipeline

A variable group must be explicitly authorized for a pipeline (or for all pipelines). A new pipeline referencing an existing group is blocked until access is granted.

Wrong group name or project scope

A typo in the group: name, or referencing a group from another project, fails to resolve - variable groups live in Library and are project-scoped.

How to fix it

Authorize the group for the pipeline

1. Go to Pipelines → Library → open the variable group → Pipeline permissions.
2. Add this pipeline (or enable "Allow access to all pipelines" if appropriate).
3. Re-run; the first run after referencing a group often surfaces an authorization prompt to approve.

Reference the group by its exact name

Link the group under variables: using the name shown in Library.

variables:
  - group: prod-secrets   # exact Library name, same project

How to prevent it

• Authorize variable groups when first wiring a pipeline.
• Keep group names consistent and project-scoped.
• Limit "all pipelines" access to non-sensitive groups; authorize secrets per pipeline.

Frequently asked questions

Related guides

References

• GitHub Actions documentation