Update a governance relationship
In brief
The article’s publication date changed to November 11, 2026, and an AI-assisted usage marker was added. It documents prerequisites and steps for updating governance policy templates, sending requests, and accepting changes.
What Entra admins need to know
Administrators can use the revised guidance when updating existing governance relationships; no action is required solely because of this documentation change.
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.
title: Update a governance relationship titleSuffix: Microsoft Entra ID Governance description: Learn how to update an existing governance relationship between a governing and governed tenant in Microsoft Entra Tenant Governance ms.topic: how-to ms.date: 11/11/2026 ai-usage: ai-assisted
Update a governance relationship
This article describes how to update an existing governance relationship between a governing tenant and a governed tenant. You might need to update a governance relationship to add or modify delegated administration roles or multitenant application configurations.
Prerequisites
You must have an active governance relationship between a governing tenant and a governed tenant.
You must have access to the governance policy template you used to create the existing relationship. If you deleted the policy template, you need to create a new relationship.
You need the Tenant Governance Administrator role.
Review license requirements for sending governance requests in Microsoft Entra licensing.
Update the governance policy template
Before you can update a governance relationship, you must first modify the governance policy template you used to establish the existing relationship. When you update the template, its version number automatically increments by one.
Sign in to the Microsoft Entra admin center as at least a Tenant Governance Administrator in the governing tenant.
Browse to Tenant Governance > Templates, and select the policy template you used to set up the relationship.
Modify the template as needed. Update one or more of these configurations:
Delegated administration roles: Add or change the Microsoft Entra built-in roles assigned to security groups in the governing tenant. These roles determine the access level that users in those groups have when they sign in to the governed tenant.
Multitenant application management: Add or update custom, multitenant applications. When you update the relationship, Tenant Governance creates or updates a service principal with the corresponding permissions in the governed tenant.
Relationship lifetime (Preview): Add or change the lifetime for an active relationship. Use the same template ID in the new Initial request to update that relationship rather than create a separate one.
Save the updated governance policy template. The version number of the template increments by one.
Renewing a time-bound relationship is different from updating its terms. Request renewal preserves the existing policy snapshot and lifetime; it doesn't apply template edits. See Manage relationship expiration and renewal.
Send a new governance request with the updated template
After updating the governance policy template, send a new governance request from the governing tenant to the governed tenant using the updated template.
In the governing tenant, create a new governance request.
Select the governed tenant that has the existing relationship you want to update.
Select the updated governance policy template.
Submit the governance request. The governed tenant receives an email notification about the new governance request.
Accept the governance request
An admin in the governed tenant must accept the governance request to complete the update.
Sign in to the Microsoft Entra admin center as at least a Tenant Governance Administrator in the governed tenant.
Browse to Tenant Governance > Received requests.
Review the updated governance request, including the changes in the policy template.
Accept the governance request. The system updates the existing governance relationship with the new policy template configuration. The governing tenant receives an email confirming the accepted request and the updated governance relationship.
When the governed tenant accepts the governance request, these changes take effect:
Tenant Governance updates the policy snapshot of the existing governance relationship to reflect the latest version of the policy template.
If you updated delegated administration roles, Tenant Governance updates the GDAP role assignments in the governed tenant accordingly.
If you updated multitenant application management, Tenant Governance updates the corresponding service principal and its permissions in the governed tenant.
If you updated the relationship lifetime, Tenant Governance updates the existing relationship's policy snapshot and expiration after acceptance.
Related content
@@ -1,77 +1,84 @@-----title: Update a governance relationship-titleSuffix: Microsoft Entra ID Governance-description: Learn how to update an existing governance relationship between a governing and governed tenant in Microsoft Entra Tenant Governance-ms.topic: how-to-ms.date: 03/10/2026------<!-- source: How to update a governance relationship.docx -->--# Update a governance relationship--This article describes how to update an existing governance relationship between a governing tenant and a governed tenant. You might need to update a governance relationship to add or modify delegated administration roles or multitenant application configurations.--## Prerequisites-- You must have an active governance relationship between a governing tenant and a governed tenant.--- You must have access to the governance policy template you used to create the existing relationship. If you deleted the policy template, you need to create a new relationship.--- You need the **Tenant Governance Administrator** role.--- Review license requirements for sending governance requests in [Microsoft Entra licensing](~/fundamentals/licensing.md#microsoft-entra-tenant-governance).--## Update the governance policy template-Before you can update a governance relationship, you must first modify the governance policy template you used to establish the existing relationship. When you update the template, its version number automatically increments by one.--1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a **Tenant Governance Administrator** in the governing tenant.--1. Browse to **Tenant Governance** > **Templates**, and select the policy template you used to set up the relationship.--1. Modify the template as needed. Update one or more of these configurations:-- - **Delegated administration roles**: Add or change the Microsoft Entra built-in roles assigned to security groups in the governing tenant. These roles determine the access level that users in those groups have when they sign in to the governed tenant.-- - **Multitenant application management**: Add or update custom, multitenant applications. When you update the relationship, Tenant Governance creates or updates a service principal with the corresponding permissions in the governed tenant.--1. Save the updated governance policy template. The version number of the template increments by one.--> [!NOTE]-> Updating the governance policy template doesn't automatically update the governance relationship. The tenant admins must complete the governance request and approval process described in the sections that follow for the policy template changes to take effect.--## Send a new governance request with the updated template-After updating the governance policy template, send a new governance request from the governing tenant to the governed tenant using the updated template.--1. In the governing tenant, create a new governance request.--1. Select the governed tenant that has the existing relationship you want to update.--1. Select the updated governance policy template.--1. Submit the governance request. The governed tenant receives an email notification about the new governance request.--## Accept the governance request-An admin in the governed tenant must accept the governance request to complete the update.--1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a **Tenant Governance Administrator** in the governed tenant.--1. Browse to **Tenant Governance** > **Received requests**.--1. Review the updated governance request, including the changes in the policy template.--1. Accept the governance request. The system updates the existing governance relationship with the new policy template configuration. The governing tenant receives an email confirming the accepted request and the updated governance relationship.--When the governed tenant accepts the governance request, these changes take effect:--- Tenant Governance updates the policy snapshot of the existing governance relationship to reflect the latest version of the policy template.--- If you updated delegated administration roles, Tenant Governance updates the GDAP role assignments in the governed tenant accordingly.--- If you updated multitenant application management, Tenant Governance updates the corresponding service principal and its permissions in the governed tenant.--## Related content-- [Set up a governance relationship](how-to-set-up-governance-relationship.md)--- [Terminate a governance relationship](how-to-terminate-governance-relationship.md)--- [Governance policy templates](governance-policy-templates.md)+---
+title: Update a governance relationship
+titleSuffix: Microsoft Entra ID Governance
+description: Learn how to update an existing governance relationship between a governing and governed tenant in Microsoft Entra Tenant Governance
+ms.topic: how-to
+ms.date: 11/11/2026
+ai-usage: ai-assisted
+---
+
+<!-- source: How to update a governance relationship.docx -->
+
+# Update a governance relationship
+
+This article describes how to update an existing governance relationship between a governing tenant and a governed tenant. You might need to update a governance relationship to add or modify delegated administration roles or multitenant application configurations.
+
+## Prerequisites
+- You must have an active governance relationship between a governing tenant and a governed tenant.
+
+- You must have access to the governance policy template you used to create the existing relationship. If you deleted the policy template, you need to create a new relationship.
+
+- You need the **Tenant Governance Administrator** role.
+
+- Review license requirements for sending governance requests in [Microsoft Entra licensing](~/fundamentals/licensing.md#microsoft-entra-tenant-governance).
+
+## Update the governance policy template
+Before you can update a governance relationship, you must first modify the governance policy template you used to establish the existing relationship. When you update the template, its version number automatically increments by one.
+
+1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a **Tenant Governance Administrator** in the governing tenant.
+
+1. Browse to **Tenant Governance** > **Templates**, and select the policy template you used to set up the relationship.
+
+1. Modify the template as needed. Update one or more of these configurations:
+
+ - **Delegated administration roles**: Add or change the Microsoft Entra built-in roles assigned to security groups in the governing tenant. These roles determine the access level that users in those groups have when they sign in to the governed tenant.
+
+ - **Multitenant application management**: Add or update custom, multitenant applications. When you update the relationship, Tenant Governance creates or updates a service principal with the corresponding permissions in the governed tenant.
+
+ - **Relationship lifetime (Preview)**: Add or change the lifetime for an active relationship. Use the same template ID in the new **Initial** request to update that relationship rather than create a separate one.
+
+1. Save the updated governance policy template. The version number of the template increments by one.
+
+> [!NOTE]
+> Updating the governance policy template doesn't automatically update the governance relationship. The tenant admins must complete the governance request and approval process described in the sections that follow for the policy template changes to take effect.
+
+Renewing a time-bound relationship is different from updating its terms. **Request renewal** preserves the existing policy snapshot and lifetime; it doesn't apply template edits. See [Manage relationship expiration and renewal](how-to-manage-relationship-expiration.md).
+
+## Send a new governance request with the updated template
+After updating the governance policy template, send a new governance request from the governing tenant to the governed tenant using the updated template.
+
+1. In the governing tenant, create a new governance request.
+
+1. Select the governed tenant that has the existing relationship you want to update.
+
+1. Select the updated governance policy template.
+
+1. Submit the governance request. The governed tenant receives an email notification about the new governance request.
+
+## Accept the governance request
+An admin in the governed tenant must accept the governance request to complete the update.
+
+1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a **Tenant Governance Administrator** in the governed tenant.
+
+1. Browse to **Tenant Governance** > **Received requests**.
+
+1. Review the updated governance request, including the changes in the policy template.
+
+1. Accept the governance request. The system updates the existing governance relationship with the new policy template configuration. The governing tenant receives an email confirming the accepted request and the updated governance relationship.
+
+When the governed tenant accepts the governance request, these changes take effect:
+
+- Tenant Governance updates the policy snapshot of the existing governance relationship to reflect the latest version of the policy template.
+
+- If you updated delegated administration roles, Tenant Governance updates the GDAP role assignments in the governed tenant accordingly.
+
+- If you updated multitenant application management, Tenant Governance updates the corresponding service principal and its permissions in the governed tenant.
+
+- If you updated the relationship lifetime, Tenant Governance updates the existing relationship's policy snapshot and expiration after acceptance.
+
+## Related content
+- [Set up a governance relationship](how-to-set-up-governance-relationship.md)
+
+- [Terminate a governance relationship](how-to-terminate-governance-relationship.md)
+
+- [Governance policy templates](governance-policy-templates.md)
