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:
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
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
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.