GitHub Actions "name is required for environment"

By Kaveh Alemi·Latchkey

When a job declares an environment as a mapping (to add a url), the name key is mandatory. Providing only url, or an empty mapping, fails validation.

What this error means

The workflow fails to start with "name is required for environment" on a job whose environment: is written as a mapping without a name.

Error: name is required for environment

Common causes

Environment mapping without name

The job used environment: { url: ... } and omitted the required name field.

Empty environment expression

An expression that builds the environment name resolved to empty, leaving no name.

How to fix it

Provide the environment name

1. Use the shorthand environment: production for a simple name.
2. When adding a url, keep name alongside it in the mapping.
3. Ensure any name expression resolves to a non-empty string.

jobs:
  deploy:
    environment:
      name: production
      url: https://app.example.com

How to prevent it

• Always include name when environment is a mapping.
• Validate environment-name expressions are non-empty.
• Prefer the string shorthand when no url is needed.

Frequently asked questions

Related guides

References

• GitHub Actions documentation
• Workflow syntax for GitHub Actions