Skip to content

Add docs about AI Usage settings page #4169

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MiloradFilipovic wants to merge 4 commits into
base: main
Choose a base branch
from
+30 −0
Open

Add docs about AI Usage settings page #4169

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
39f681f
Add docs about AI Usage settings page
MiloradFilipovic Feb 2, 2026
60a142a
👌 Re-phrasing and typo fixing
MiloradFilipovic Feb 2, 2026
0e0c838
⚡ Change title level in the privacy page
MiloradFilipovic Feb 2, 2026
c996f3e
⚡ Update n8n version with privacy settings
MiloradFilipovic Feb 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/_images/ai-assistant/ai_usage_settings.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 20 additions & 0 deletions docs/manage-cloud/ai-assistant.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,26 @@
- "How can I build X in n8n?"
<!-- vale from-microsoft.FirstPerson = YES -->

## AI Usage settings
Copy link
Copy Markdown
Contributor

@RoRoJ RoRoJ Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## AI Usage settings
## AI usage settings


/// info
Available in n8n v2.7.0 and above.
///

You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance settings. Here, you can control what data is shared with the AI Assistant.

Check warning on line 39 in docs/manage-cloud/ai-assistant.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[from-write-good.Passive] 'is shared' may be passive voice. Use active voice if you can.

Raw Output:
{"message": "[from-write-good.Passive] 'is shared' may be passive voice. Use active voice if you can.", "location": {"path": "docs/manage-cloud/ai-assistant.md", "range": {"start": {"line": 39, "column": 147}}}, "severity": "WARNING"}
Copy link
Copy Markdown
Contributor

@RoRoJ RoRoJ Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance settings. Here, you can control what data is shared with the AI Assistant.
You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance. Here, you can control what data is shared with the AI Assistant.


These settings are only available to the instance owners and administrators and will apply to all users on the instance.

![ai_usage_settings.png](/_images/ai-assistant/ai_usage_settings.png)

Here, you can toggle whether to share actual workflow data (like node names, parameters, and structure) with the AI Assistant. Disabling this option will limit the assistant's ability to provide context-aware help based on your workflows.

Since access to workflow data is essential for the AI Workflow builder to function, **disabling this option will also disable the AI Workflow builder feature**.

### Disable sending data

To stop sending actual data values to the AI Assistant, turn off the **Send actual data values** checkbox on the **AI Usage** settings page.

## FAQs

<!-- vale from-microsoft.HeadingPunctuation = NO -->
Expand Down
10 changes: 10 additions & 0 deletions docs/privacy-security/privacy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -144,6 +144,16 @@ To provide enhanced assistance, n8n integrates AI-powered features that leverage

To assist and improve user experience, n8n may send specific context data to LLMs. This context data is strictly limited to information about the current workflow. n8n does not send any values from credential fields or actual output data to AI services. The data will not be incorporated, used, or retained to train the models of the AI services. Any data will be deleted after 30 days.

#### AI Usage settings
Copy link
Copy Markdown
Contributor

@RoRoJ RoRoJ Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### AI Usage settings
#### AI usage settings


/// info
Available in n8n v2.7.0 and above.
///

You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance settings.
Copy link
Copy Markdown
Contributor

@RoRoJ RoRoJ Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance settings.
You can manage your AI usage settings by navigating to **Settings** > **AI Usage** in your n8n instance.


More details can be found on the [AI Assistant documentation page](/manage-cloud/ai-assistant.md#ai-usage-settings).

#### When n8n shares data

Data is only sent to AI services if workspaces have opted in to use the assistant. The Assistant is enabled by default for n8n Cloud users. When a workspace opts in to use the assistant, node-specific data is transmitted only during direct interactions and active sessions with the AI assistant, ensuring no unnecessary data sharing occurs.
Expand Down