Add Reference for WPF

16 Nov 20234 minutes to read

Syncfusion Reference Manager is the Visual Studio Add-In for WPF platform. It adds the Syncfusion assembly reference to the project, either from the GAC location or from Essential Studio installed location or from NuGet packages. It can also migrate the projects that contain the old versions of the Syncfusion assembly reference to newer or specific versions of the Syncfusion assembly reference. It supports Microsoft Visual Studio 2013 or higher. This Visual Studio extension is included from Essential Studio 2013 Volume 3 release.


This Reference Manager can be applied to a project for Syncfusion assembly versions and later.

To add the Syncfusion assembly references in Visual Studio, follow the steps below:

Check whether the WPF Extensions - Syncfusion are installed or not in Visual Studio Extension Manager by going to Tools -> Extensions and Updates -> Installed for Visual Studio 2017 or lower, and Extensions -> Manage Extensions -> Installed for Visual Studio 2019 by going to Extensions -> Manage Extensions -> Installed. If this extension not installed, please install the extension by follow the steps from the download and installation help topic.

  1. Open a new or existing WPF application.

  2. To open Syncfusion Reference Manager Wizard, follow either one of the options below:

    Option 1:
    Click Syncfusion Menu and choose Essential Studio for WPF > Add References… in Visual Studio.

    Syncfusion Reference Manager via Syncfusion Menu


    From Visual Studio 2019, Syncfusion menu is available under Extensions in Visual Studio menu.

    Syncfusion Reference Manager via Syncfusion Menu

    Option 2:

    Right-click the selected project file from Solution Explorer, then select Syncfusion Reference Manager… from Context Menu. The following screenshot shows this option in Visual Studio.

    Syncfusion Reference Manager add-in

  3. The Syncfusion Reference Manager Wizard displays a list of loaded Syncfusion WPF controls.

    Syncfusion Reference Manger Wizard

    Platform Selection: Platform selection option will appear as an option in Syncfusion Reference Manager if opened from a Console/Class Library project. Select the appropriate platform.

    Platform selection option in Syncfusion Reference Manger


    The platform selection option will appear only if Essential Studio for Enterprise Edition with the platforms WPF and Windows Forms has been installed, or if both Essential Studio for WPF and WinForms has been installed.

    Assembly From: Choose the assembly location, either from NuGet packages, the build installed location, or by using the GAC location.


    The installed location and GAC option will be available only when the Syncfusion Essential Studio WPF setup has been installed.

    Assembly location option in Syncfusion Reference Manger


    The GAC option will not be available when you select the WPF (.NET 8.0, .NET 7.0, and.NET 6.0) application in Visual Studio 2022.

    Version: To add the corresponding version assemblies to the project, select the build version.

    Assembly location option in Syncfusion Reference Manger

    Themes Option: Choose the necessary themes based on your requirements. To learn more about built-in themes and their available assembly, click the link below.

    Themes selection option in Syncfusion Reference Manger


    Themes option will be enabled only if we selected theme supported controls.

    Themes selection option notification in Syncfusion Reference Manger

  4. Select the required controls you want to add in your project. Then click **Done to add the project’s required assemblies for the specified controls. The list of required assemblies for the selected controls to be added is shown in the screenshot below.

    Syncfusion Reference Manager new assemblies add information dialog

  5. Click OK. The listed Syncfusion assemblies are added to project. Then it notifies “Syncfusion assemblies have been added successfully” in Visual Studio status bar.

    Syncfusion Reference Manager success status in Visual Studio status bar

  6. Then, Syncfusion licensing registration required message box will be shown if you installed the trial setup or NuGet packages since Syncfusion introduced the licensing system from 2018 Volume 2 (v16.2.0.41) Essential Studio release. Navigate to the help topic, which is shown in the licensing message box to generate and register the Syncfusion license key to your project. Refer to this blog post for understanding the licensing changes introduced in Essential Studio.

    Syncfusion license registration required information dialog in Syncfusion Reference Manager


Reference Manager support is provided by Syncfusion for select versions of the.NET Framework that are included (as assemblies) in the Syncfusion Essential Studio installation. If you try to add Syncfusion assemblies to a project and the project framework isn’t compatible with the specified Syncfusion version assemblies, a dialogue box shows with the message “Current build v{version} isn’t compatible with this framework v{Framework} Version”.