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.
- Stop the XWiki instance.
- 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 - Restart the XWiki instance, add a user, then open "Administration" > "Users & Rights" > "Groups" and find each group you listed:

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

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
- Rights, which is what the wiki grants through these groups.
- View Groups You Belong To, for the user's own view of them.