> For the complete documentation index, see [llms.txt](https://cogna8-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cogna8-io.gitbook.io/docs/troubleshooting/action-blocked.md).

# Action Blocked

A blocked action means the system found conditions that make execution unsafe, incomplete, or non-compliant under the current policy and state. **This is often the intended behavior.**

***

## First Checks

Start in the Action Gate Panel and review: missing required state, unresolved conflicts on required keys, policy condition failures, and whether the result is a warn or block.

Then open the Why Panel if the reason chain is not immediately clear.

***

## Common Causes

* Required state was never captured or promoted
* A conflict exists on a dependency for the action
* The active scope is not the one you expected
* Policy constraints are stricter than the current workflow stage supports

***

## Fast Recovery

{% stepper %}
{% step %}
**Identify the blocking reason**

In Actions or Why.
{% endstep %}

{% step %}
**Fix the underlying condition**

Resolve state or policy issue.
{% endstep %}

{% step %}
**Re-evaluate**

Re-run or re-evaluate the action path.
{% endstep %}

{% step %}
**Confirm**

Verify the new gate result before proceeding.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Do not work around repeated blocks by disabling governance unless you have verified the policy is wrong.** Repeated blocks often reveal missing process steps upstream. Cogna8 is most valuable precisely where it prevents clean-looking actions built on unstable state.
{% endhint %}