Skip to content
Open
Changes from all commits
Commits
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
11 changes: 11 additions & 0 deletions docs/contacts/tags.rst
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,17 @@

.. vale off
Viewing and removing Tags on a Contact
**************************************

.. vale on
A Contact's Tags appear on the Contact's detail page in a dedicated Tags tile. If a Contact has 8 or fewer Tags, the tile shows all of them. If a Contact has more than 8, the tile shows the first 8 and becomes expandable - use the control on the tile to view the remaining Tags.

Check warning on line 71 in docs/contacts/tags.rst

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Landing Page' instead of 'page'. Raw Output: {"message": "[Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Landing Page' instead of 'page'.", "location": {"path": "docs/contacts/tags.rst", "range": {"start": {"line": 71, "column": 49}}}, "severity": "INFO"}

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The 8-Tag threshold and expandable tile behavior come from lead.html.twig, where maxVisibleTagsCount = 8 selects a tile--base for 8 or fewer Tags and a tile--expandable-interactive (first 8 above the fold, remainder below) when tagCount > maxVisibleTagsCount.

Source: mautic/mautic#15845


To remove a Tag from the Contact's detail page, click the **x** icon on the Tag. Mautic displays a confirmation dialog asking 'Are you sure you want to remove this tag from the contact?'. Click **Confirm** to remove the Tag, or **Cancel** to keep it. This confirmation step prevents you from accidentally removing a Tag with a single click.

Check warning on line 73 in docs/contacts/tags.rst

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Contact' instead of 'contact'. Raw Output: {"message": "[Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Contact' instead of 'contact'.", "location": {"path": "docs/contacts/tags.rst", "range": {"start": {"line": 73, "column": 178}}}, "severity": "INFO"}

Check warning on line 73 in docs/contacts/tags.rst

View workflow job for this annotation

GitHub Actions / prose

[vale] reported by reviewdog 🐶 [Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Landing Page' instead of 'page'. Raw Output: {"message": "[Mautic.FeatureList] Is this referring to a Mautic feature? If so, use 'Landing Page' instead of 'page'.", "location": {"path": "docs/contacts/tags.rst", "range": {"start": {"line": 73, "column": 43}}}, "severity": "INFO"}

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The exact confirmation message 'Are you sure you want to remove this tag from the contact?' comes from the new mautic.lead.tag.confirm_remove string added in app/bundles/LeadBundle/Translations/en_US/javascript.ini, and the Mautic.removeTagFromLead/confirmRemoveTagFromLead changes in lead.js introduce the Confirm/Cancel dialog before removing a Tag.

Source: mautic/mautic#15845


.. vale off
Using Tags in Campaigns
***********************

Expand Down
Loading