How do notification policies work with spaces and stacks?

Last updated: July 14, 2025

Context

When setting up notification policies in Spacelift, users may be unsure about how these policies interact with spaces and stacks, particularly regarding policy attachment and webhook configuration.

Answer

Notification policies in Spacelift operate differently from other policy types. Here are the key points to understand:

  1. Space-Level Operation: Notification policies work at the space level, not the stack level. This means:

    • You don't need to attach them directly to stacks

    • They will automatically work on all stacks/modules within the spaces they can access

  2. Inheritance:

    • If you place a notification policy in the root space with inheritance enabled, all stacks will inherit this policy

    • The same principle applies to webhooks - they will be inherited by child spaces if placed in the root space with inheritance enabled

  3. Stack-Specific Filtering: If you need to limit notifications to specific stacks, you can add a condition to your policy:

    input.stack.name ==

Note: Unlike other policies, notification policies do not use the auto-attachment label system. They are automatically evaluated for any action within their accessible spaces.