# Hiding the notification preferences, example and legacy activity macros from the macro lists

**URL:** <https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044>\
**Category:** Development\
**Tags:** proposal\
**Created:** [October 27, 2026, 9:11am UTC](https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044 "2026-10-27T09:11:29Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![CharpentierLucas](https://forum.xwiki.org/user_avatar/forum.xwiki.org/charpentierlucas/32/4830_2.png) [@CharpentierLucas](https://forum.xwiki.org/u/CharpentierLucas)\
**Post date:** [October 27, 2026, 9:11am UTC](https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044/1 "2026-10-27T09:11:30Z")

</div>

Hi!

## Context

During the [WYSIWYG usability audit of the macros](https://design.xwiki.org/xwiki/bin/view/Proposal/WYSIWYGusabilityofXWikimacros/Macros/), I found a few macros that the Insert Macro dialog and Quick Actions offer to every user, although they aren’t meant to be inserted in a content page.

Only two categories can hide a macro: Internal and Deprecated. They are the default value of `rendering.transformation.macro.hiddenCategories`, and the macros in them are left out of both the Insert Macro dialog and Quick Actions for the users who don’t display hidden pages. Pages that already call these macros keep rendering them; only the lists change. We already did this for `spaces`, `spacesIndex` and `workspaces` in [XWIKI-14561](https://jira.xwiki.org/browse/XWIKI-14561).

## Proposal

1. **Move the notification preferences macros to Internal** ([XWIKI-25468](https://jira.xwiki.org/browse/XWIKI-25468)): `notificationsApplicationsPreferences`, `notificationsAutoWatchPreferences`, `notificationsCustomFiltersPreferences`, `notificationsEmailPreferences` and `notificationsSystemFiltersPreferences`. They are only meant for the notification preferences of the user profile and wiki administration. Today they show up in the Notifications category next to the Notifications macro, and typing `/notif` lists all of them. The 6th one, `notificationsFiltersPreferences`, goes to **Deprecated** instead, since it has been replaced by the custom and system filters macros ([XWIKI-18406](https://jira.xwiki.org/browse/XWIKI-18406)).
2. **Move the `example` macro of the Help application to Internal** ([XWIKI-25018](https://jira.xwiki.org/browse/XWIKI-25018)). It only builds the Help pages, where it shows a rendered example next to its source: it is used 19 times in the `Help.Macros.*` pages and documented nowhere for users. It is in the Formatting category today, next to macros users actually insert.
3. **Move the `activity` macro, “Activity (legacy)”, to Deprecated** ([XWIKI-16047](https://jira.xwiki.org/browse/XWIKI-16047)). It only keeps the pages written for the old Activity Stream application working: it lives in a legacy module and passes its parameters on to the Notifications macro. It is still offered in the Notifications category, next to the Notifications macro, which shows the same events with more options. Its description would also say that the Notifications macro replaces it.

## Opinion

+1 for the 3 points because:

- None of these macros actually target users.
- They clutter the lists, sometimes right next to the macro the user is looking for, like `/notif` or `/filters`.
- It’s cheap and safe: only the default category changes, existing pages keep rendering the same, and the users who display hidden pages will still see them.
- Those macros are far from being usable, marking them as internal/deprecated makes our intent clear (we won’t improve their usability).

## Conclusion

- Do you agree to move the 5 notification preferences macros to Internal, and `notificationsFiltersPreferences` to Deprecated?
- Do you agree to move the `example` macro to Internal?
- Do you agree to move the `activity` macro to Deprecated?

Thank you in advance for sharing your opinion!  
Lucas C.

---

<div class="post-metadata">

**Author:** ![surli](https://forum.xwiki.org/user_avatar/forum.xwiki.org/surli/32/2687_2.png) [@surli](https://forum.xwiki.org/u/surli)\
**Post date:** [October 27, 2026, 10:08am UTC](https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044/2 "2026-10-27T10:08:53Z")

</div>

+1 on all propositions, thanks!

---

<div class="post-metadata">

**Author:** ![mleduc](https://forum.xwiki.org/user_avatar/forum.xwiki.org/mleduc/32/2328_2.png) [@mleduc](https://forum.xwiki.org/u/mleduc)\
**Post date:** [October 28, 2026, 7:21am UTC](https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044/3 "2026-10-28T07:21:48Z")

</div>

+1 thanks

---

<div class="post-metadata">

**Author:** ![CharpentierLucas](https://forum.xwiki.org/user_avatar/forum.xwiki.org/charpentierlucas/32/4830_2.png) [@CharpentierLucas](https://forum.xwiki.org/u/CharpentierLucas)\
**Post date:** [November 4, 2026, 3:38pm UTC](https://forum.xwiki.org/t/hiding-the-notification-preferences-example-and-legacy-activity-macros-from-the-macro-lists/19044/4 "2026-11-04T15:38:31Z")

</div>

3 +1 on all those changes.

I’ll consider those three points as approved, and move on with the fixes for [XWIKI-25468](https://jira.xwiki.org/browse/XWIKI-25468) , [XWIKI-25018](https://jira.xwiki.org/browse/XWIKI-25018) and [XWIKI-16047](https://jira.xwiki.org/browse/XWIKI-16047).

Thank you for participating!  
If you disagree with this proposal, please make it known on this topic, the faster the better 🙂
