Forum Discussion
GIT integration: azure devop - fabric
- 6 months agoPrefer the “Save As → Commit → delete old → Commit” pattern for renames done from the Fabric UI.
Hi Antongig ,
According to Microsoft Learn this is an expected due to how Fabric identifies items. Microsoft Learn.
Fabric uses a Logical ID (a unique GUID) to track artifacts, rather than their display name. When you rename a notebook in the UI, Fabric updates the displayName property inside the metadata but does not always rename the physical folder in Git.
Official Solutions from Microsoft Learn & Community
You do not need to delete and recreate everything. Here are the recommended ways to fix the naming mismatch:
Option 1: The "Save As" Method (Cleanest)
As noted in the Fabric Community discussions referenced by Microsoft support:
In Fabric, open your notebook and select Save As with the New Name.
Go to the Source Control panel and Commit the new notebook.
Delete the old notebook from the Fabric workspace.
Commit that deletion to Git. This forces Git to remove the old folder and create a new one with the correct name.
Option 2: Manual Git Folder Rename
If you are comfortable with Git:
Clone the repo locally or use the Azure DevOps "Rename" feature in the Browser.
Rename the artifact's folder to NewName.Notebook.
Crucial: Open item.metadata.json and ensure the displayName matches the new name.
Commit and push these changes.
In Fabric, go to Source Control and click Update All. Fabric will re-bind the item using its Logical ID.
Option 3: Disconnect/Reconnect (The "Soft Reset")
Go to Workspace Settings > Git Integration.
Disconnect the workspace.
In Azure DevOps, manually rename the folder to your preferred name.
Reconnect the workspace to the branch.
Choose the sync direction that prioritizes your corrected Git folder.
If this post helps, then please appreciate giving a Kudos or accepting as a Solution to help the other members find it more quickly.
If I misunderstand your needs or you still have problems on it, please feel free to let us know. Thanks a lot!