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 previewshouldwas intended onlybe used infor test environmentsasbecause itcancould affect dynamic group processinginacross 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 groupsusingthat used thememberOfattribute.TheThese groupsmemberOfcountcounted toward the total dynamic group quota of 15,000.Each dynamic group
can havecould reference up to 50membersource groups.
nested groups weren't included.When you add members of security groups tomemberOfdynamic membership groups, onlyOnly direct members ofthe security group become memberssource groups were included. Members ofthe dynamic group.You can't use oneAmemberOfdynamic grouptocouldn't define the membership of anothermemberOfdynamic 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
rules or operators.memberOfattributecancouldn't beusedcombined with otherrules. 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.The dynamic group rule builder and
.validate feature canrule validation weren'tbe usedsupported formemberOfat this time.ThememberOfattribute 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."
processing for the tenant.Users included inmemberOfdynamic 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 membershipgroups updates.Membership
of a memberOf dynamic group doesndidn't automatically update when achildsource groupiswas deleted.The affectedAffected users or devicesremainremained membersof the memberOf dynamic groupuntil the ruleiswas 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
Sign in to the Microsoft Entra admin center as at least a User AdministratorUse MemberOf Next and Transitive Reports To in dynamic membership groups (preview).Browse toEntra ID>Groups>All groupsManage rules for dynamic membership groups in Microsoft Entra ID.SelectNew groupUnderstand and manage dynamic group processing in Microsoft Entra ID.Fill in group details. The group type can beSecurityorMicrosoft 365, and the membership type can be set toDynamic UserorDynamic Device.SelectAdd dynamic query.MemberOf isn't yet supported in the rule builder UI. SelectEditto write the rule in theRule syntaxbox.Example user rule:user.memberof -any (group.objectId -in ['groupId'])Example device rule:device.memberof -any (group.objectId -in ['groupId'])
Related content
- Select OK.
- 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
memberOfwith supported rule operators, or convert the group to assigned membership.
Dynamic administrative units
Use Microsoft Graph PowerShell to identify dynamic administrative units that usememberOfrules.ReplacememberOf-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 usememberOf.ReplacememberOf-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.
@@ -1,106 +1,52 @@ ----title: Configure dynamic membership groups with the memberOf operator in the Entra Admin Center (preview)-description: Learn how to create a dynamic membership group that can contain members of other groups in Microsoft Entra ID.-ms.topic: how-to-ms.date: 08/04/2026+title: Deprecated memberOf preview for dynamic membership groups+description: Learn about the deprecated memberOf preview for dynamic membership groups in Microsoft Entra ID and find guidance for moving to MemberOf Next.+ms.topic: concept-article+ms.date: 11/16/2026 ms.reviewer: mbhargav ms.custom: it-pro+ai-usage: ai-assisted+# Customer intent: As an IT admin, I want to understand the deprecated memberOf preview and find its replacement, so that I can move existing configurations to MemberOf Next. --- -# Configure dynamic membership groups with the memberOf operator in the Entra Admin Center (preview)---## Overview--This feature preview in Microsoft Entra ID enables admins to create dynamic membership groups and administrative units that populate by adding members of other groups using the `memberOf` attribute. Apps that couldn't read group-based membership previously in Microsoft Entra ID can now read the entire membership of these new `memberOf` groups. Not only can these groups be used for apps but they can also be used for licensing assignments.+# Deprecated memberOf preview for dynamic membership groups > [!IMPORTANT]-> The public preview of the `memberOf` rule operator is ending. After **November 3, 2026**, dynamic membership groups, dynamic administrative units, and entitlement management auto-assignment policies that use the `memberOf` operator stop updating and remain in their last known state. This can lead to stale access and enforcement gaps, including outdated Teams and SharePoint access, Conditional Access targeting, group-based licensing, and access package assignments.+> The earlier `memberOf` preview was deprecated in favor of **MemberOf Next**. The earlier preview ended on **November 3, 2026**. Dynamic membership groups, dynamic administrative units, and entitlement management auto-assignment policies that still used the earlier preview stopped updating and remained in their last known state. >-> Before November 3, 2026, review all uses of the `memberOf` operator and remove or replace those configurations. See [Migrate before the preview ends](#migrate-before-the-preview-ends). This is a preview feature that isn't intended for production use; review the [Preview limitations](#preview-limitations). ---The following diagram illustrates how you could create Dynamic-Group-A with members of Security-Group-X and Security-Group-Y. Members of the groups inside Security-Group-X and Security-Group-Y don't become members of Dynamic-Group-A.+> For current capabilities, requirements, and setup instructions, see [Use MemberOf Next and Transitive Reports To in dynamic membership groups (preview)](groups-dynamic-rule-advanced.md). To move existing groups to MemberOf Next, see [Move existing MemberOf groups to MemberOf Next](groups-dynamic-rule-advanced.md#move-existing-memberof-groups-to-memberof-next). -:::image type="content" source="./media/groups-dynamic-rule-member-of/member-of-diagram.png" alt-text="Diagram that shows how the memberOf attribute works.":::+The earlier `memberOf` preview in Microsoft Entra ID enabled admins to create dynamic membership groups and administrative units that populated by adding members of other groups. Apps that couldn't read group-based membership previously could read the flattened membership of these `memberOf` groups. These groups could also be used for licensing assignments. -With this preview, admins can configure dynamic membership groups with the `memberOf` attribute in the Azure portal, Microsoft Graph, and PowerShell. Security groups, Microsoft 365 groups, and 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.+The following diagram illustrates how the earlier preview populated Dynamic-Group-A with direct members of Security-Group-X and Security-Group-Y. Members of nested groups inside Security-Group-X and Security-Group-Y weren't included in Dynamic-Group-A. -## Prerequisites+:::image type="content" source="./media/groups-dynamic-rule-member-of/member-of-diagram.png" alt-text="Diagram that shows how the memberOf attribute worked in the deprecated preview."::: -You must be at least a [User Administrator](/entra/identity/role-based-access-control/permissions-reference#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.+The earlier preview was available through the Azure portal, Microsoft Graph, and PowerShell. Source groups could be security groups, Microsoft 365 groups, or groups synced from on-premises Active 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](groups-dynamic-rule-advanced.md#preview-limitations). -- This preview should only be used in test environments as it can affect dynamic group processing in the tenant. These limitations are being addressed, and updates will be provided when they're available.-- Each Microsoft Entra tenant is limited to 500 dynamic groups using the `memberOf` attribute. The `memberOf` groups count toward the total dynamic group quota of 15,000.-- Each dynamic group can have up to 50 member groups.-- When you add members of security groups to `memberOf` dynamic membership groups, only direct members of the security group become members of the dynamic group.-- You can't use one `memberOf` dynamic group to 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 can't be used 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.-- The dynamic group rule builder and validate feature can't be used 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 number of groups or frequent dynamic membership groups updates.-- Membership of a memberOf dynamic group doesn't automatically update when a child group is deleted. The affected users or devices remain members of the memberOf dynamic group until the rule is modified.---- Only available in public cloud. --## Get started--This feature is available in the Azure portal, Microsoft Graph, 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).--### Create a memberOf dynamic group--1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [User Administrator](~/identity/role-based-access-control/permissions-reference.md#user-administrator).-1. Browse to **Entra ID** > **Groups** > **All groups**.-1. Select **New group**.-1. Fill in group details. The group type can be **Security** or **Microsoft 365**, and the membership type can be set to **Dynamic User** or **Dynamic Device**.-1. Select **Add dynamic query**.-1. MemberOf isn't yet supported in the rule builder UI. Select **Edit** to write the rule in the **Rule syntax** box.- 1. Example user rule: `user.memberof -any (group.objectId -in ['groupId'])`- 1. Example device rule: `device.memberof -any (group.objectId -in ['groupId'])` - - > [!NOTE]- > Replace `'groupId'` with the **object ID of the source group** whose members you want to include in the dynamic group.- >- > The two examples are alternatives:- >- > - Use the **user** rule when creating a **Dynamic user** group.- > - Use the **device** rule when creating a **Dynamic device** group.- >- > To include multiple source groups, specify multiple group object IDs. For example:- >- > ```text- > user.memberof -any (group.objectId -in ['<groupObjectId1>', '<groupObjectId2>'])- > ```--1. Select **OK**.-1. 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](~/identity/users/groups-dynamic-rule-more-efficient.md), or convert the group to assigned membership.-- Validate group membership after making changes. If the group is no longer needed, pause or delete it.+- The earlier preview was intended only for test environments because it could affect dynamic group processing across the tenant.+- Each Microsoft Entra tenant was limited to 500 dynamic groups that used the `memberOf` attribute. These groups counted toward the total dynamic group quota of 15,000.+- Each dynamic group could reference up to 50 source groups.+- Only direct members of source groups were included. Members of nested groups weren't included.+- A `memberOf` dynamic group couldn't define the membership of another `memberOf` dynamic group.+- The `memberOf` attribute couldn't be combined with other rules or operators.+- The dynamic group rule builder and rule validation weren't supported for `memberOf`.+- Large numbers of groups or frequent membership updates could slow dynamic membership processing for the tenant.+- Membership didn't automatically update when a source group was deleted. Affected users or devices remained members until the rule was modified.+- The earlier preview was available only in the public cloud. -**Dynamic administrative units**+## Move to MemberOf Next -- Use Microsoft Graph PowerShell to identify [dynamic administrative units](~/identity/role-based-access-control/admin-units-members-dynamic.md) 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.+MemberOf 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 product and the rule syntax are unchanged. -**Entitlement management auto-assignment policies**+For migration requirements and instructions, see [Move existing MemberOf groups to MemberOf Next](groups-dynamic-rule-advanced.md#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)](groups-dynamic-rule-advanced.md). -- Use Microsoft Graph PowerShell to identify [auto-assignment policies](~/id-governance/entitlement-management-access-package-auto-assignment-policy.md) 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.+## Related content +- [Use MemberOf Next and Transitive Reports To in dynamic membership groups (preview)](groups-dynamic-rule-advanced.md).+- [Manage rules for dynamic membership groups in Microsoft Entra ID](groups-dynamic-membership.md).+- [Understand and manage dynamic group processing in Microsoft Entra ID](manage-dynamic-group.md). 