Skip to content

Correct conflicting instruction regarding `Restrict membership by email` field

What does this MR do and why?

Corrects conflicting instruction regarding Restrict membership by email field

Current instruction:

You can prevent users with email addresses in specific domains from being added to a group and its projects. You can define an email domain allowlist at the top-level namespace only. Subgroups do not offer the ability to define an alternative allowlist.

To restrict group access by domain:

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > General.
  3. Expand the Permissions and group features section.
  4. In the Restrict membership by email field, enter the domain names.

Proposed instruction:

To ensure only users with email addresses in specific domains are being added to a group and its projects, define an email domain allowlist at the top-level namespace. Subgroups do not offer the ability to define an alternative allowlist.

To restrict group access by domain:

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > General.
  3. Expand the Permissions and group features section.
  4. In the Restrict membership by email field, enter the domain names.
  5. Select Save changes.

MR acceptance checklist

Please evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.

Screenshots or screen recordings

Screenshots are required for UI changes, and strongly recommended for all other merge requests.

Before After

How to set up and validate locally

Numbered steps to set up and validate the change are strongly suggested.

Edited by Chantal Lawrence

Merge request reports