Skip to content

Add documentation for unmanaged layer removal during upgrades#10669

Closed
Copilot wants to merge 4 commits intomainfrom
copilot/fix-unmanaged-layer-removal
Closed

Add documentation for unmanaged layer removal during upgrades#10669
Copilot wants to merge 4 commits intomainfrom
copilot/fix-unmanaged-layer-removal

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 7, 2026

Users following the upgrade instructions cannot find the "Remove unmanaged layer" button referenced in documentation. The Power Platform interface labels this button "Remove active customizations" instead.

Changes

New Documentation

  • CenterofExcellenceResources/Documentation/FAQ-Upgrade.md - Explains terminology mismatch between documentation ("unmanaged layer") and UI ("Remove active customizations"), provides step-by-step removal instructions, covers why layers occur and upgrade implications
  • CenterofExcellenceResources/Documentation/TROUBLESHOOTING.md - Quick-reference guide with symptom-solution format and visual cues for identifying the correct button
  • CenterofExcellenceResources/Documentation/README.md - Navigation guide for when to use each document

Updated References

  • Main README.md and release collateral readme now link to troubleshooting and FAQ resources under upgrade sections

Key Points

The button labeled "Remove active customizations" removes unmanaged layers. Users should:

  1. Navigate to Solution Layers for the component
  2. Select row where Solution = "Unmanaged layer" (Order ≥ 2, Layer Status = "Active")
  3. Click "Remove active customizations"
Original prompt

This section details on the original issue you should resolve

<issue_title>[CoE Starter Kit - QUESTION] Unmanaged Layer not able to remove</issue_title>
<issue_description>### Does this question already exist in our backlog?

  • I have checked and confirm this is a new question.

What is your question?

Hello,

When following the steps to update the COE (https://learn.microsoft.com/en-us/power-platform/guidance/coe/after-setup) we get to the unmanaged layer step. When we navigate to the unamanged layer we do not have an option to "Removed unmanaged layer".

Image

Thanks,
Ben

What solution are you experiencing the issue with?

None

What solution version are you using?

1.0.20230727.2

What app or flow are you having the issue with?

Command center app > Get M365 Service Messages

What method are you using to get inventory and telemetry?

None</issue_description>

<agent_instructions>Need answer to this question</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Custom agent used: CoE Custom Agent
Specialized agent for triaging and fixing issues in the CoE Starter Kit. Always consult the official CoE docs and the team’s SharePoint notes first, then mine prior GitHub issues and the CoE Common Responses playbook.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 3 commits January 7, 2026 05:47
Co-authored-by: mohamrizwa <220306360+mohamrizwa@users.noreply.github.com>
Co-authored-by: mohamrizwa <220306360+mohamrizwa@users.noreply.github.com>
Co-authored-by: mohamrizwa <220306360+mohamrizwa@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix issue with removing unmanaged layer Add documentation for unmanaged layer removal during upgrades Jan 7, 2026
Copilot AI requested a review from mohamrizwa January 7, 2026 05:51
@mohamrizwa mohamrizwa closed this Feb 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CoE Starter Kit - QUESTION] Unmanaged Layer not able to remove

2 participants