diff --git a/docs/_images/workflows/sharing-within-projects.png b/docs/_images/workflows/sharing-within-projects.png
new file mode 100644
index 000000000..d9212e166
Binary files /dev/null and b/docs/_images/workflows/sharing-within-projects.png differ
diff --git a/docs/workflows/sharing.md b/docs/workflows/sharing.md
index a62eb1927..0f3c53db0 100644
--- a/docs/workflows/sharing.md
+++ b/docs/workflows/sharing.md
@@ -20,6 +20,12 @@ Users can share workflows they created. Instance owners, and users with the admi
 3. In **Add users**, find and select the users you want to share with.
 4. Select **Save**.
 
+**Note:** This option is only available when sharing a workflow that is inside a **Personal** workspace. When trying to use the "Add users" option for a workflow that's **inside a project**, you'll get this pop-up instead:
+
+![Screenshot of the sharing option within projects](/_images/workflows/sharing-within-projects.png)
+
+This is intended behavior, and it means that the workflow is shared with everyone inside that specific project. Instead of adding the user directly to the workflow, you need to add the user to the project in which the workflow is located.
+
 ## View shared workflows
 
 You can browse and search workflows on the **Workflows** list. The workflows in the list depend on the project: