Microsoft Entra ID
General

Deprecated memberOf preview for dynamic membership groups

In brief

The earlier memberOf preview ended on November 3, 2026. Dynamic groups, dynamic administrative units, and entitlement management auto-assignment policies using it no longer update and remain in their last known state. The documentation directs admins to MemberOf Next.

What Entra admins need to know

Review existing configurations and move them to MemberOf Next to restore ongoing updates.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

ConfigureDeprecated memberOf preview for dynamic membership groups with the memberOf operator in the Entra Admin Center (preview)

Overview

This featureThe earlier memberOf preview in Microsoft Entra ID enablesenabled admins to create dynamic membership groups and administrative units that populatepopulated by adding members of other groups using the memberOf attribute.groups. Apps that couldn't read group-based membership previously in Microsoft Entra ID can nowcould read the entireflattened membership of these new memberOf groups. Not only can theseThese groups be used for apps but they cancould also be used for licensing assignments.

The following diagram illustrates how you could createthe earlier preview populated Dynamic-Group-A with direct members of Security-Group-X and Security-Group-Y. Members of thenested groups inside Security-Group-X and Security-Group-Y donweren't become members ofincluded in Dynamic-Group-A.

:::image type="content" source="./media/groups-dynamic-rule-member-of/member-of-diagram.png" alt-text="Diagram that shows how the memberOf attribute works.worked in the deprecated preview.":::

With this preview, admins can configure dynamic membership groups with the memberOf attribute inThe earlier preview was available through the Azure portal, Microsoft Graph, and PowerShell. SecuritySource groups could be security groups, Microsoft 365 groups, andor groups that are synced from on-premises Active Directory can all be added as members of these dynamic membership groups. They can also all be added to a single group. For example, the dynamic group could be a security group, but you can use Microsoft 365 groups, security groups, and groups that are synced from on-premises to define its membership.

Prerequisites

You must be at least a User Administrator to use the memberOf attribute to create a Microsoft Entra dynamic group. You must have a Microsoft Entra ID P1 or P2 license for the Microsoft Entra tenant.Directory.

Preview limitations

The following limitations applied to the deprecated preview. For the limitations of its replacement, see MemberOf Next and Transitive Reports To preview limitations.

  • ThisThe earlier preview shouldwas intended only be used infor test environments asbecause it cancould affect dynamic group processing inacross the tenant. These limitations are being addressed, and updates will be provided when they're available.

  • Each Microsoft Entra tenant iswas limited to 500 dynamic groups usingthat used the memberOf attribute. The memberOfThese groups countcounted toward the total dynamic group quota of 15,000.

  • Each dynamic group can havecould reference up to 50 membersource groups.

  • When you add members of security groups to memberOf dynamic membership groups, onlyOnly direct members of the security group become memberssource groups were included. Members of the dynamic group.

    nested groups weren't included.
  • You can't use oneA memberOf dynamic group tocouldn't define the membership of another memberOf dynamic group. For example, Dynamic Group A, with members of group B and C in it, can't be a member of Dynamic Group D.

  • The memberOf attribute cancouldn't be usedcombined with other rules. For example, a rule that states dynamic group A should contain members of group B and also should contain only users located in Redmond will fail.

    rules or operators.
  • The dynamic group rule builder and validate feature canrule validation weren't be usedsupported for memberOf at this time.

    .
  • The memberOf attribute can't be used with other operators. For example, you can't create a rule that states "Members Of group A can't be in Dynamic group B."

  • Users included in memberOf dynamic membership groups might cause a slower processing time for your tenant, if the tenant has a large numberLarge numbers of groups or frequent membership updates could slow dynamic membership groups updates.

    processing for the tenant.
  • Membership of a memberOf dynamic group doesndidn't automatically update when a childsource group iswas deleted. The affectedAffected users or devices remainremained members of the memberOf dynamic group until the rule iswas modified.

  • OnlyThe earlier preview was available only in the public cloud.

Get startedMove to MemberOf Next

This feature is availableMemberOf Next replaces the earlier preview with separate processing on a twice-daily schedule. It requires Microsoft Entra ID Governance and Standard priority. The name shown in the Azure portal, Microsoft Graph,product and PowerShell. However, the memberOf attribute isn’t currently supported in the rule builder UI. To use memberOf in the Azure portal, you must define the rule by using the rule editor (advanced syntax)syntax are unchanged.

For migration requirements and instructions, see Move existing MemberOf groups to MemberOf Next. For current setup instructions and guidance for dynamic administrative units, see Use MemberOf Next and Transitive Reports To in dynamic membership groups (preview).

Create a memberOf dynamic group

    Related content

  1. Select OK.
  2. Select Create group.

Migrate before the preview ends

As Microsoft continues to improve the scale and reliability of dynamic membership processing, the memberOf preview is ending. During preview, we observed that using memberOf can slow dynamic membership processing for all groups in a tenant. memberOf is a preview operator and isn't recommended for production use.

We recognize the importance of the customer scenarios that memberOf addresses, and we're continuing to develop an alternative solution that meets these needs with the right level of scalability and reliability. In the interim, identify and replace every configuration that uses the memberOf operator before November 3, 2026. After that date, configurations that still use memberOf stop updating and stay in their last known state, which can leave access stale and enforcement gaps in place.

Dynamic membership groups

  • Export dynamic membership groups from the Microsoft Entra admin center and identify rules that contain memberOf.
  • Replace memberOf with supported rule operators, or convert the group to assigned membership.
  • Validate group membership after making changes. If the group is no longer needed, pause or delete it.

Dynamic administrative units

  • Use Microsoft Graph PowerShell to identify dynamic administrative units that use memberOf rules.
  • Replace memberOf-based rules with supported logic, or convert the administrative unit to assigned membership.
  • Validate both membership and administrative scope. If the administrative unit is no longer needed, delete it.

Entitlement management auto-assignment policies

  • Use Microsoft Graph PowerShell to identify auto-assignment policies that use memberOf.
  • Replace memberOf-based logic with supported attribute-based operators where possible. If no equivalent rule is available, plan an alternative assignment method before retirement.
  • Validate access package assignments after making changes.
Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…