Migration Overview: Syncfusion^® .NET MAUI to Syncfusion^® Toolkit for .NET MAUI

11 Sep 20253 minutes to read

To ensure a smooth migration from Syncfusion^® .NET MAUI to the Syncfusion^® Toolkit for .NET MAUI controls, we have designed the Toolkit components to closely resemble those in Syncfusion^® .NET MAUI. This approach minimizes the changes required during migration, with the primary difference being the use of toolkit-specific namespaces.
By preserving similar APIs and functionality, developers can easily update their existing projects to use the new toolkit with minimal code modifications. Refer to the table below for a detailed overview of the necessary changes:

XAML Namespaces

Controls	Syncfusion® .NET MAUI Namespace	Syncfusion® Toolkit for .NET MAUI Namespace	Description
SfAccordion	xmlns:accordion="clr-namespace:Syncfusion.Maui.Accordion;assembly=Syncfusion.Maui.Expander"	xmlns:accordion="clr-namespace:Syncfusion.Maui.Toolkit.Accordion;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfAccordion control.
SfButton	xmlns: button ="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons"	xmlns:button ="clr-namespace:Syncfusion.Maui.Toolkit.Buttons;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfButton control.
SfCalendar	xmlns: calendar ="clr-namespace:Syncfusion.Maui.Calendar;assembly=Syncfusion.Maui.Calendar"	xmlns:calendar="clr-namespace:Syncfusion.Maui.Toolkit.Calendar;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCalendar control.
SfCards	xmlns:cards="clr-namespace:Syncfusion.Maui.Cards;assembly=Syncfusion.Maui.Cards"	xmlns:cards="clr-namespace:Syncfusion.Maui.Toolkit.Cards;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCards control.
SfCarousel	xmlns: carousel ="clr-namespace:Syncfusion.Maui.Carousel;assembly=Syncfusion.Maui.Carousel"	xmlns:carousel="clr-namespace:Syncfusion.Maui.Toolkit.Carousel;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart	xmlns:chart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts"	xmlns:chart="clr-namespace:Syncfusion.Maui.Toolkit.Charts;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfCircularProgressBar	xmlns:progressBar="clr-namespace:Syncfusion.Maui.ProgressBar;assembly=Syncfusion.Maui.ProgressBar"	xmlns:progressBar="clr-namespace:Syncfusion.Maui.Toolkit.ProgressBar;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfCircularProgressBar control.
SfChip	xmlns:chip="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:chip="clr-namespace:Syncfusion.Maui.Toolkit.Chips;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfChip control.
SfEffectsView	xmlns:effectsView="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:effectsView="clr-namespace:Syncfusion.Maui.Toolkit.EffectsView;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfEffectsView control.
SfExpander	xmlns:expander="clr-namespace:Syncfusion.Maui.Expander;assembly=Syncfusion.Maui.Expander"	xmlns:expander="clr-namespace:Syncfusion.Maui.Toolkit.Expander;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfExpander control.
SfLinearProgressBar	xmlns:progressBar="clr-namespace:Syncfusion.Maui.ProgressBar;assembly=Syncfusion.Maui.ProgressBar"	xmlns:progressBar="clr-namespace:Syncfusion.Maui.Toolkit.ProgressBar;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfLinearProgressBar control.
SfNavigationDrawer	xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.NavigationDrawer;assembly=Syncfusion.Maui.NavigationDrawer"	xmlns:navigationDrawer="clr-namespace:Syncfusion.Maui.Toolkit.NavigationDrawer;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNavigationDrawer control.
SfNumericEntry	xmlns:numericEntry ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs"	xmlns:numericEntry="clr-namespace:Syncfusion.Maui.Toolkit.NumericEntry;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNumericEntry control.
SfNumericUpDown	xmlns:numericUpDown ="clr-namespace:Syncfusion.Maui.Inputs;assembly=Syncfusion.Maui.Inputs"	xmlns:numericUpDown="clr-namespace:Syncfusion.Maui.Toolkit.NumericUpDown;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfNumericUpDown control.
SfPicker	xmlns:picker="clr-namespace:Syncfusion.Maui.Picker;assembly=Syncfusion.Maui.Picker"	xmlns:picker="clr-namespace:Syncfusion.Maui.Toolkit.Picker;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfPicker control.
SfPopup	xmlns:popup="clr-namespace:Syncfusion.Maui.Popup;assembly=Syncfusion.Maui.Popup"	xmlns:popup="clr-namespace:Syncfusion.Maui.Toolkit.Popup;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfPopup control.
SfPullToRefresh	xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.PullToRefresh;assembly=Syncfusion.Maui.PullToRefresh"	xmlns:pullToRefreshControl="clr-namespace:Syncfusion.Maui.Toolkit.PullToRefresh;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfPullToRefresh control.
SfSegmentedControl	xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons"	xmlns:segmentedControl="clr-namespace:Syncfusion.Maui.Toolkit.SegmentedControl;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfSegmentedControl.
SfShimmer	xmlns:shimmer="clr-namespace:Syncfusion.Maui.Shimmer;assembly=Syncfusion.Maui.Core"	xmlns:shimmer="clr-namespace:Syncfusion.Maui.Toolkit.Shimmer;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfShimmer control.
SfSunburstChart	xmlns:sunburst="clr-namespace:Syncfusion.Maui.SunburstChart;assembly=Syncfusion.Maui.SunburstChart"	xmlns:sunburst="clr-namespace:Syncfusion.Maui.Toolkit.SunburstChart;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfSunburstChart control.
SfTabView	xmlns:tabView="clr-namespace:Syncfusion.Maui.TabView;assembly=Syncfusion.Maui.TabView"	xmlns:tabView="clr-namespace:Syncfusion.Maui.Toolkit.TabView;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfTabView control.
SfTextInputLayout	xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Core;assembly=Syncfusion.Maui.Core"	xmlns:inputLayout="clr-namespace:Syncfusion.Maui.Toolkit.TextInputLayout;assembly=Syncfusion.Maui.Toolkit"	Defines the XAML namespace for SfTextInputLayout control.

C# Namespaces

Controls	Syncfusion® .NET MAUI Namespace	Syncfusion® Toolkit for .NET MAUI Namespace	Description
SfButton	Syncfusion.Maui.Buttons	Syncfusion.Maui.Toolkit.Buttons	Defines the namespace for SfButton control.
SfCalendar	Syncfusion.Maui.Calendar	Syncfusion.Maui.Toolkit.Calendar	Defines the namespace for SfCalendar control.
SfCards	Syncfusion.Maui.Cards	Syncfusion.Maui.Toolkit.Cards	Defines the namespace for SfCards control.
SfCarousel	Syncfusion.Maui.Carousel	Syncfusion.Maui.Toolkit.Carousel	Defines the namespace for SfCarousel control.
SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart	Syncfusion.Maui.Charts	Syncfusion.Maui.Toolkit.Charts	Defines the namespace for SfCartesianChart, SfCircularChart, SfFunnelChart, SfPolarChart, and SfPyramidChart controls.
SfCircularProgressBar	Syncfusion.Maui.ProgressBar	Syncfusion.Maui.Toolkit.ProgressBar	Defines the namespace for SfCircularProgressBar control.
SfChip	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.Chip	Defines the namespace for SfChip control.
SfEffectsView	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.EffectsView	Defines the namespace for SfEffectsView control.
SfLinearProgressBar	Syncfusion.Maui.ProgressBar	Syncfusion.Maui.Toolkit.ProgressBar	Defines the namespace for SfLinearProgressBar control.
SfNavigationDrawer	Syncfusion.Maui.NavigationDrawer	Syncfusion.Maui.Toolkit.NavigationDrawer	Defines the namespace for SfNavigationDrawer control.
SfNumericEntry	Syncfusion.Maui.Inputs	Syncfusion.Maui.Toolkit.NumericEntry	Defines the namespace for SfNumericEntry control.
SfNumericUpDown	Syncfusion.Maui.Inputs	Syncfusion.Maui.Toolkit.NumericUpDown	Defines the namespace for SfNumericUpDown control.
SfPicker	Syncfusion.Maui.Picker	Syncfusion.Maui.Toolkit.Picker	Defines the namespace for SfPicker control.
SfPopup	Syncfusion.Maui.Popup	Syncfusion.Maui.Toolkit.Popup	Defines the namespace for SfPopup control.
SfPullToRefresh	Syncfusion.Maui.PullToRefresh	Syncfusion.Maui.Toolkit.PullToRefresh	Defines the namespace for SfPullToRefresh control.
SfSegmentedControl	Syncfusion.Maui.Buttons	Syncfusion.Maui.Toolkit.SegmentedControl	Defines the namespace for SfSegmentedControl.
SfShimmer	Syncfusion.Maui.Shimmer	Syncfusion.Maui.Toolkit.Shimmer	Defines the namespace for SfShimmer control.
SfSunburstChart	Syncfusion.Maui.SunburstChart	Syncfusion.Maui.Toolkit.SunburstChart	Defines the namespace for SfSunburstChart control.
SfTabView	Syncfusion.Maui.TabView	Syncfusion.Maui.Toolkit.TabView	Defines the namespace for SfTabView control.
SfTextInputLayout	Syncfusion.Maui.Core	Syncfusion.Maui.Toolkit.TextInputLayout	Defines the namespace for SfTextInputLayout control.
Common	Syncfusion.Maui.Core.Hosting	Syncfusion.Maui.Toolkit.Hosting	Provides functionality for configure your .NET MAUI application through the AppHostBuilder.

C# Methods

Controls	Syncfusion® .NET MAUI	Syncfusion® Toolkit for .NET MAUI	Description
Common	ConfigureSyncfusionCore()	ConfigureSyncfusionToolkit()	Configures the implemented handlers in Syncfusion.Maui.Toolkit.