Set the Initial Groups of New Users

Last modified by Eleni Cojocariu on 2026/09/11 22:51

Steps

A new account is added to the groups listed by the xwiki.users.initialGroups property of the xwiki.cfg configuration file, whether it was created from the Administration, by a registration form or by an authenticator.

  1. Stop the XWiki instance.
  2. Open xwiki/WEB-INF/xwiki.cfg, uncomment xwiki.users.initialGroups and list the group Pages, separated by commas:
    xwiki.users.initialGroups=XWiki.XWikiAllGroup, XWiki.DocWriters
  3. Restart the XWiki instance, add a user, then open "Administration" > "Users & Rights" > "Groups" and find each group you listed:

    initial-groups-list.png

  4. Click the group's "Edit" action and check that the new user is one of its members:

    initial-groups-members.png

FAQ

Are the accounts that already exist added to the groups?

No. The groups are applied when an account is created, so add the existing users to the group yourself.

What happens when a group listed does not exist?

XWiki creates the group Page when it adds the first user to it, so a name with a typo in it produces a group nobody notices.

Which groups is a user added to when the property is left unset?

XWiki.XWikiAllGroup alone, unless xwiki.authentication.group.allgroupimplicit is set to 1: the property then has no default, and a new user is added to no group Page at all, although every user still counts as a member of XWiki.XWikiAllGroup.

Related

Get Connected