How do I fix "Codemagic.yaml references to unknown variable group(s)" error?

Last updated: June 30, 2026

Context

You may encounter an error message stating Codemagic.yaml references to unknown variable group(s): google_play_credentials when running a build. This error occurs when your YAML configuration file references an environment variable group that hasn't been properly defined in your Codemagic project settings.

Answer

This error means that your codemagic.yaml file contains a reference to an environment variable group that doesn't exist in your project settings. Here's how to resolve it:

Step 1: Check your YAML configuration

Look for a section in your codemagic.yaml file that looks like this:

environment:
  groups:
    - google_play_credentials

Step 2: Verify the group name matches your settings

The group name in your YAML must exactly match the name you've defined in your Codemagic project settings. For example, if you've created a group called "google_credentials" in your settings, your YAML should reference:

environment:
  groups:
    - google_credentials
Image of a Codemagic YAML settings page showing a highlighted missing environment variable group named 'google_credentials' under Global variables and secrets.