umbraco-add-extension-reference
Add Extension Reference to Umbraco Instance
What is it?
After creating a new Umbraco backoffice extension project, it must be added as a project reference in the main Umbraco instance's .csproj file. Without this reference, the extension will not be loaded when running the Umbraco site.
If a solution file (.sln) exists, the extension should also be added to it for proper IDE support (Visual Studio, Rider). This is optional - the extension will work without being in the solution.
When to Use
Use this skill after:
- Creating a new extension with
dotnet new umbraco-extension - Moving or copying an extension project to your solution
- Setting up a new extension from the
umbraco-backofficeblueprints
Workflow
Step 1: Find the Main Umbraco Project
The main Umbraco instance .csproj file must be discovered dynamically. Search for it using these criteria:
More from umbraco/umbraco-cms-backoffice-skills
umbraco-backoffice
Umbraco backoffice extension customisation - complete working examples showing how extension types combine
184umbraco-controllers
Understand and create controllers in Umbraco backoffice (foundational concept)
170umbraco-extension-template
Create new Umbraco backoffice extensions using the official dotnet template
169umbraco-dashboard
Implement dashboards in Umbraco backoffice using official docs
169umbraco-quickstart
Quick setup for Umbraco extension development - creates instance, extension, and registers it
167umbraco-property-editor-ui
Implement property editor UIs in Umbraco backoffice using official docs
164