Skip to content

Document dedicated Notes permissions#704

Open
promptless-for-oss wants to merge 4 commits into
mautic:7.1from
Promptless:promptless/notes-permissions
Open

Document dedicated Notes permissions#704
promptless-for-oss wants to merge 4 commits into
mautic:7.1from
Promptless:promptless/notes-permissions

Conversation

@promptless-for-oss
Copy link
Copy Markdown

Open this suggestion in Promptless to view citations and reasoning process

Documents the new Notes permission model that provides fine-grained control over Contact note management, separate from Contact permissions. Updates both Roles configuration docs and Contact management docs.

Trigger Events


Tip: Enable auto-create PR in your Docs Collection to publish suggestions automatically 🤖

Add documentation for the new lead:notes permission model introduced in Mautic 8.x:
- Add Notes permission category to managing_roles.rst with explanation of fine-grained note access control
- Expand Notes section in manage_contacts.rst with note ownership visibility and permissions
@promptless-for-oss promptless-for-oss requested a review from a team as a code owner May 1, 2026 07:00
.. note::
Contact permissions
~~~~~~~~~~~~~~~~~~~

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Added Notes permission category documentation based on PR #16067 which introduces lead:notes as a separate permission bundle with View/Edit/Create/Delete permissions independent of Contact permissions. The permission is registered in LeadPermissions.php via addExtendedPermissions('notes', false) and appears in the Roles UI as "Notes - User has access to".

Source: mautic/mautic#16067

@promptless-for-oss promptless-for-oss requested review from adiati98 and favour-chibueze and removed request for a team May 1, 2026 07:00
Comment thread docs/contacts/manage_contacts.rst Outdated
=====

It's possible to use Mautic as a basic Customer Relationship Management system (CRM). You or your teammates can write notes for a specific Contact. It's possible to mark a note with a specific purpose; General, Email, Call, Meeting. It's also possible to define a date of a meeting or a call.
You can use Mautic as a basic Customer Relationship Management system (CRM). You or your teammates can write notes for a specific Contact. Mark a note with a specific purpose: General, Email, Call, or Meeting. You can also define a date for a meeting or a call.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Added Note permissions section based on PR #16067. The PR modifies NoteController.php to check note-level permissions (lead:notes:editown, lead:notes:deleteown) based on $note->getCreatedBy() rather than contact-level permissions, enabling users to edit/delete their own notes on any contact they can view.

Source: mautic/mautic#16067

Copy link
Copy Markdown
Contributor

@adiati98 adiati98 left a comment

Choose a reason for hiding this comment

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

@promptless-for-oss please address the suggestions

Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst
Comment thread docs/users_roles/managing_roles.rst
Comment thread docs/users_roles/managing_roles.rst Outdated
@adiati98 adiati98 requested review from a team and shinde-rahul May 15, 2026 13:13
Apply all six reviewer suggestions:
- Use dashes for CRM abbreviation and add "such as"
- Lowercase "notes permissions" consistently throughout
- Add vale off/on around Contact Permissions section
escopecz
escopecz previously approved these changes May 15, 2026
Copy link
Copy Markdown
Member

@escopecz escopecz left a comment

Choose a reason for hiding this comment

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

Looks good 👍

@adiati98 adiati98 added this to the Mautic 7.2 milestone May 18, 2026
Copy link
Copy Markdown
Contributor

@adiati98 adiati98 left a comment

Choose a reason for hiding this comment

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

@promptless-for-oss please address the suggestions

Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/contacts/manage_contacts.rst Outdated
Comment thread docs/users_roles/managing_roles.rst Outdated
Comment thread docs/users_roles/managing_roles.rst Outdated
Address reviewer feedback to consistently capitalize "Notes" and "Note"
throughout the documentation since they refer to a Mautic feature.
@promptless-for-oss
Copy link
Copy Markdown
Author

Thanks for the feedback, @adiati98! I've addressed all your suggestions by capitalizing "Notes" and "Note" consistently as Mautic feature names throughout the documentation.

Changes made:

  • docs/contacts/manage_contacts.rst: Updated 9 instances — capitalized "notes" → "Notes" and "note" → "Note" in the Notes section description, permissions explanation, and bullet points
  • docs/users_roles/managing_roles.rst: Updated 2 instances — capitalized in the Notes permission category description and the explanatory note

Please let me know if there's anything else you'd like me to adjust.

@adiati98
Copy link
Copy Markdown
Contributor

adiati98 commented May 18, 2026

@escopecz can I confirm here if "Notes" is one of Mautic's features?

@escopecz
Copy link
Copy Markdown
Member

Yes, it is :)
Screenshot 2026-05-19 at 10 16 29

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants