Dependencies

Model relationships between flags so Vexil can warn you before you accidentally break dependent features.

What is a dependency?

A dependency edge means "Flag B requires Flag A to be enabled." If you disable Flag A, Flag B becomes effectively inactive even if its own toggle is still on. Without this relationship modelled, it's easy to forget which flags rely on each other.

Adding a dependency

1. 1
   Open the flag detail page

   Click on any flag in the list.
2. 2
   Go to the Dependencies tab

   You'll see two sections: "Depends on" and "Required by".
3. 3
   Click "Add dependency"

   Search for the parent flag by key name.
4. 4
   Select and save

   Vexil checks for circular dependencies automatically and rejects anything that would create a cycle.

Cascade disable

When you try to disable a flag that other flags depend on, Vexil shows a warning modal listing all the flags that would be affected. You can:

• Cancel — leave everything as-is.
• Disable all — atomically disable the parent flag and every enabled flag that depends on it.

Dependency graph

The Graph page in the sidebar shows all flag dependencies across your organization as an interactive diagram. Nodes are colour-coded: green for enabled in production, muted for disabled, red for archived. Click any node to jump to that flag's detail page.