[DOCS] Settings page missing "Workflow keyword trigger" setting added in v2.1.157
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/settings
Section/Topic
"Available settings" table — the disableWorkflows row and any new row that should be added for the keyword-trigger-specific setting. Also the "Turn workflows off" section at https://code.claude.com/docs/en/workflows.
Current Documentation
The settings page lists only disableWorkflows, which disables dynamic workflows entirely:
disableWorkflows— Disable dynamic workflows and the bundled workflow commands. Default:false. Equivalent to settingCLAUDE_CODE_DISABLE_WORKFLOWSto1
The workflows page shows a /config toggle that also disables workflows entirely:
Toggle Dynamic workflows off in /config. Persists across sessions.
And describes what happens when workflows are fully disabled:
When workflows are disabled, the bundled workflow commands are unavailable, theworkflowkeyword no longer triggers a run, andultracodeis removed from the/effortmenu.
The only per-prompt workaround offered is:
If Claude Code highlights the word when you didn't mean to trigger one, press alt+w to ignore it for this prompt.
What's Wrong or Missing?
As of v2.1.157, Claude Code added a "Workflow keyword trigger" setting in /config that lets users stop the word "workflow" in a prompt from automatically triggering a dynamic workflow, without disabling workflows entirely.
The settings page does not document this setting or its corresponding JSON key (e.g., disableWorkflowKeywordTrigger or similar). The workflows page does not mention this more granular option — it only describes the all-or-nothing disableWorkflows toggle and the per-prompt alt+w escape.
Users who want to keep workflows available (e.g., running saved workflows with /<name>) but never want the word "workflow" to auto-trigger one have no documented way to configure this. They currently have no choice between "disable everything" and "press alt+w every time."
Suggested Improvement
A. Settings page — add new row to the Available Settings table
Add a row for the new setting between disableWorkflows and editorMode, for example:
| `disableWorkflowKeywordTrigger` | Prevent the word "workflow" in a prompt from automatically triggering a dynamic workflow. Saved workflows run with `/<name>` still work. Default: `false`. Appears in `/config` as **Workflow keyword trigger**. | `true` |
B. Workflows page — update the "Turn workflows off" section
After the existing list of ways to turn workflows off entirely, add a subsection:
### Stop the keyword from triggering workflows
To stop the word "workflow" in a prompt from automatically launching a dynamic workflow, while keeping saved workflows accessible with `/<name>`:
* Toggle **Workflow keyword trigger** off in `/config`. Persists across sessions.
* Set `"disableWorkflowKeywordTrigger": true` in `~/.claude/settings.json`. Persists across sessions.
When the keyword trigger is disabled, typing "workflow" in a prompt no longer highlights or triggers a workflow run. Saved workflows at `/<name>` and the `/workflows` command remain available.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | Settings table row for new disableWorkflowKeywordTrigger setting needed |
| https://code.claude.com/docs/en/workflows | "Turn workflows off" section should mention the keyword-trigger-specific toggle |
Total scope: 2 pages affected
Referenced changelog: v2.1.157 — "Added a 'Workflow keyword trigger' setting in /config to stop the word 'workflow' in a prompt from triggering a dynamic workflow"
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗