Skip to content

Update navigation methods and information names to match UI#651

Open
mheavey2 wants to merge 2 commits intomautic:5.2from
mheavey2:docs/issue498-update-info
Open

Update navigation methods and information names to match UI#651
mheavey2 wants to merge 2 commits intomautic:5.2from
mheavey2:docs/issue498-update-info

Conversation

@mheavey2
Copy link
Contributor

Description

update navigation methods and information names to match UI.

Linked issue

Closes #498

@mheavey2 mheavey2 requested a review from a team as a code owner February 25, 2026 17:52
@mheavey2 mheavey2 requested review from adiati98 and favour-chibueze and removed request for a team February 25, 2026 17:52
Copy link
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.

Thanks for the PR, @mheavey2! ✨

I left some suggestions and questions here. 🙂

To add a new action:

1. Click **Points > Point Actions > + New** - located in the top right corner.
1. Click **Points > Manage Actions > + New** - located in the top right corner.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
1. Click **Points > Manage Actions > + New** - located in the top right corner.
1. On the left side, navigate to **Points > Manage Actions** and click the **New** button located in the top right corner.

* **Change Points (+/-)** - The value change to set for the action. The ``+`` isn't necessary when adding Points. When subtracting Points, add the ``-`` symbol.

* **Actions taken by User** - This is the behavior or action the Contact must complete to trigger the action.
* **Actions taken by contact** - This is the behavior or action the Contact must complete to trigger the action.
Copy link
Contributor

Choose a reason for hiding this comment

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

I understand that on the form, the "Contact" is in lowercase. However, Contact is Mautic's feature and that's why Vale gives warning. So, let's change this to uppercase.

I think we can also adjust the wording.

Suggested change
* **Actions taken by contact** - This is the behavior or action the Contact must complete to trigger the action.
* **Actions taken by Contact** - The specific Contact activity required to trigger the point action.

* **Actions taken by User** - This is the behavior or action the Contact must complete to trigger the action.
* **Actions taken by contact** - This is the behavior or action the Contact must complete to trigger the action.

* **Point Group** - This is the Point Group you want the action applied to.
Copy link
Contributor

@adiati98 adiati98 Feb 25, 2026

Choose a reason for hiding this comment

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

Let's reword this for clarity.

Suggested change
* **Point Group** - This is the Point Group you want the action applied to.
* **Point group** - Identify the target group for the action. An empty selection applies the action to all main Contact points by default.


* **Category** - Organize your Point Actions based on their goals, Campaigns, etc. For more information, see :doc:`Categories</categories/categories-overview>`. All Points accumulate on a Contact record, regardless of Category. There is one Points score for each Contact.

* **Projects** - Organize your Point Actions based on their Campaigns project.
Copy link
Contributor

Choose a reason for hiding this comment

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

Where do you see "Projects"? Because I don't see it anywhere on the right side.

Image

Comment on lines +56 to +58
To add a new trigger:

1. Click **Points > Manage Triggers > + New** - located in the top right corner. This opens in the **Details** tab.
Copy link
Contributor

Choose a reason for hiding this comment

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

Because there's only a single point, I think we better squash this into one sentence.

Suggested change
To add a new trigger:
1. Click **Points > Manage Triggers > + New** - located in the top right corner. This opens in the **Details** tab.
On the left side, navigate to **Points > Manage Triggers** and click the **New** button located in the top right corner to create a new point trigger.

:alt: Screenshot of Points trigger

Creating Point Triggers is like creating Point Actions. The **Name**, **Description**, **Category**, and **Active** options are all the same. The trigger fires based on the minimum number of Points. Set a number and decide if you want to **Trigger for existing applicable Contacts upon saving - if activated**.
Creating Point Triggers is like creating Point Actions. The **Name**, **Description**, **Point Group**, **Category**, **Projects** and **Active** options are all the same. The trigger fires based on the minimum number of Points. Set a number and decide if you want to **Trigger for existing applicable Contacts upon saving - if activated**.
Copy link
Contributor

Choose a reason for hiding this comment

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

There are a couple of things here:

  • I still don't see "Projects" anywhere in New Trigger
  • Unlike point actions, there's "Contact color" in point triggers. We need to include and explain that.

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.

[DOCS]: Update information in docs/points/points.rst in branch 5.2

2 participants