diff --git a/agent/workflows.mdx b/agent/workflows.mdx
index b2eabe066..03e3753c5 100644
--- a/agent/workflows.mdx
+++ b/agent/workflows.mdx
@@ -118,6 +118,12 @@ By default, the agent opens a pull request for each workflow run so you can revi
 automerge: true
 ```
 
+## Limits
+
+Each workflow can run up to 20 times per 24-hour rolling window. Runs that fail do not count toward this limit.
+
+If a workflow exceeds the limit, additional runs are rejected until older runs fall outside the 24-hour window.
+
 ## Prompts
 
 Effective prompts focus on one task and have a specific outcome in mind. Workflows always have some variance because of the nondeterministic nature of agents, but you can improve the consistency of workflow outputs by following these best practices.