Syncfusion.Maui.Buttons
35.1.46
Prefix Reserved
dotnet add package Syncfusion.Maui.Buttons --version 35.1.46
NuGet\Install-Package Syncfusion.Maui.Buttons -Version 35.1.46
<PackageReference Include="Syncfusion.Maui.Buttons" Version="35.1.46" />
<PackageVersion Include="Syncfusion.Maui.Buttons" Version="35.1.46" />
<PackageReference Include="Syncfusion.Maui.Buttons" />
paket add Syncfusion.Maui.Buttons --version 35.1.46
#r "nuget: Syncfusion.Maui.Buttons, 35.1.46"
#:package Syncfusion.Maui.Buttons@35.1.46
#addin nuget:?package=Syncfusion.Maui.Buttons&version=35.1.46
#tool nuget:?package=Syncfusion.Maui.Buttons&version=35.1.46
Syncfusion .NET MAUI Buttons
The Syncfusion .NET MAUI Buttons package includes five fully-featured controls for .NET MAUI apps: Button, Segmented Control, CheckBox, RadioButton, and Switch. Each was built from the ground up for a native look and feel with rich customization, and works in Android, iOS, macOS, and Windows from a single codebase.
Documentation · Getting Started · API Reference · Demos on GitHub · Product Page · Release Notes
Using this package with an AI coding agent
Before generating Syncfusion code, ask your AI coding agent to run the Syncfusion setup using the following prompt:
Set up this project for Syncfusion before generating code. Fetch and follow the official instructions at https://ai.syncfusion.com, then report the detected platform, installed skill pack, MCP status, and any required licensing action.The setup detects your project’s platform and loads the appropriate Syncfusion skill pack. No Syncfusion account or MCP key is required to install or read Syncfusion agent skills.
Platform reference: https://ai.syncfusion.com/maui/llms.txt
Controls in this package
| Control | Purpose |
|---|---|
| SfButton | Custom button with icons, predefined styles, rounded corners, and visual state customization |
| SfCheckBox | Select one or more options; supports checked, unchecked, and indeterminate states |
| SfRadioButton | Select one option from a set, with support for grouping radio buttons |
| SfSegmentedControl | Multiple segments where each segment acts as a separate button with text, image, or both |
| SfSwitch | Toggle between two states with fully customizable appearance |
Key features
Button
- Text and background customization (
TextTransform,LineBreakMode,TextColor,Background). - Icon support with
ShowIconandImageSource, plus icon placement viaImageAlignment. - Predefined styles, rounded corners via
CornerRadius, stroke customization (StrokeThickness), and visual state customization using the visual state manager. - Custom content support through the
Content(DataTemplate) property.

CheckBox
- Three-state checkbox (
IsCheckedsupportstrue,false, andnullindeterminate, enabled byIsThreeState). - State change notification via the
StateChangedandStateChangingevents. - Customize the check state, size, colors (such as
TickColor,CheckedColor,UncheckedColor), corner radius, and label placement.

Radio Button
- Two-state radio button (
IsCheckedistrueorfalse). - Group radio buttons in an
SfRadioGroupso only one can be selected at a time; the group raisesCheckedChangedto notify which button was selected. - State change notification via the
StateChangedandStateChangingevents. - Customize the check state, size, colors (such as
CheckedColor,UncheckedColor), and label placement.

Segmented Control
- Segments display text, an image (
SfSegmentItem.ImageSource), or both. - Selection notification via
SelectionChangedandTappedevents, withSelectedIndexto get or set the selected segment. - Overflow handling with
VisibleSegmentsCount, and programmatic scrolling withScrollTo. - Enable or disable segments at run time using
SetSegmentEnabled. - Customizable selection indicator (
SelectionIndicatorSettings), corner radius, stroke, and segment spacing.

Switch
- Smooth toggle between on and off states (
IsOn), with an optional indeterminate state viaAllowIndeterminateState. - State change notification via the
StateChangedandStateChangingevents. - Fully customizable thumb and track through
SwitchSettings- including backgrounds, strokes, sizes, corner radii, and custom thumb/track images.

All controls
- Full styling support with built-in light and dark themes.
- Right-to-left (RTL) support, localization, and accessibility.
Supported platforms
| Platform | Target framework |
|---|---|
| Android | net9.0-android, net10.0-android |
| iOS | net9.0-ios, net10.0-ios |
| macOS (Mac Catalyst) | net9.0-maccatalyst, net10.0-maccatalyst |
| Windows | net9.0-windows10.0.19041, net10.0-windows10.0.19041 |
Minimum OS versions follow the .NET MAUI supported platforms.
Installation
.NET CLI
dotnet add package Syncfusion.Maui.Buttons
Package Manager Console
Install-Package Syncfusion.Maui.Buttons
Getting started
1. Register the Syncfusion core handler
In MauiProgram.cs, call ConfigureSyncfusionCore():
using Syncfusion.Maui.Core.Hosting;
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.ConfigureSyncfusionCore();
return builder.Build();
}
}
2. Add the controls to your page
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:syncfusion="clr-namespace:Syncfusion.Maui.Buttons;assembly=Syncfusion.Maui.Buttons"
x:Class="YourAppNamespace.MainPage">
<VerticalStackLayout Spacing="20" Padding="20">
<syncfusion:SfButton Text="Submit" />
<syncfusion:SfCheckBox Text="Accept terms and conditions" IsChecked="True" />
<syncfusion:SfRadioButton Text="Credit card" />
<syncfusion:SfRadioButton Text="PayPal" />
<syncfusion:SfSwitch IsOn="True" />
<syncfusion:SfSegmentedControl>
<syncfusion:SfSegmentedControl.ItemsSource>
<x:Array Type="{x:Type x:String}">
<x:String>Day</x:String>
<x:String>Week</x:String>
<x:String>Month</x:String>
</x:Array>
</syncfusion:SfSegmentedControl.ItemsSource>
</syncfusion:SfSegmentedControl>
</VerticalStackLayout>
</ContentPage>
Run the app on any supported platform to see the controls in action.
Common scenarios
Respond to state changes
SfSwitch, SfCheckBox, and SfRadioButton raise StateChanging and StateChanged events so you can validate or react to user interaction:
private void SfSwitch_StateChanged(object sender, SwitchStateChangedEventArgs e)
{
// e.NewValue is the new switch state (e.OldValue holds the previous one).
}
<syncfusion:SfSwitch StateChanged="SfSwitch_StateChanged" />
SfSegmentedControl raises SelectionChanged when the selected segment changes:
private void SegmentedControl_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
// e.AddedItems[0] is the newly selected segment.
// e.RemovedItems[0] is the previously selected segment.
}
Group radio buttons
Place radio buttons inside an SfRadioGroup so selecting one automatically deselects the others:
<syncfusion:SfRadioGroup>
<syncfusion:SfRadioButton Text="Small" />
<syncfusion:SfRadioButton Text="Medium" IsChecked="True" />
<syncfusion:SfRadioButton Text="Large" />
</syncfusion:SfRadioGroup>
Add an icon to a button
Set ShowIcon to True and provide an ImageSource; use ImageAlignment to position it:
<syncfusion:SfButton Text="Download"
ShowIcon="True"
ImageSource="download.png"
ImageAlignment="Start" />
For more features, see the Button, CheckBox, RadioButton, Segmented Control, and Switch documentation.
Dependencies
Installing this package also installs the following packages:
Microsoft.Maui.ControlsSyncfusion.Maui.Core
License
This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's EULA. You can purchase a license here or start a free 30-day trial here.
Register your license key
Register the key in App.xaml.cs before the app is built:
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR_LICENSE_KEY");
For details, see Licensing overview.
Support and feedback
- Support tickets: Syncfusion Support Portal
- Community forums: .NET MAUI Forums
- Feature requests and bug reports: Feedback Portal
- Samples: Syncfusion .NET MAUI demos on GitHub
About Syncfusion®
Founded in 2001 and headquartered in Research Triangle Park, N.C., Syncfusion® has more than 26,000+ customers and more than 1 million users, including large financial institutions, Fortune 500 companies, and global IT consultancies.
Today, we provide 1600+ components and frameworks for web (Blazor, ASP.NET Core, ASP.NET MVC, ASP.NET WebForms, JavaScript, Angular, React, Vue, and Flutter), mobile (.NET MAUI, Xamarin, Flutter, UWP, and JavaScript), and desktop development (WinForms, WPF, WinUI, Flutter and UWP). We provide ready-to-deploy enterprise software for dashboards, reports, data integration, and big data processing. Many customers have saved millions in licensing fees by deploying our software.
sales@syncfusion.com | www.syncfusion.com | Toll Free: 1-888-9 DOTNET
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-android36.0 is compatible. net10.0-browser was computed. net10.0-ios was computed. net10.0-ios26.0 is compatible. net10.0-maccatalyst was computed. net10.0-maccatalyst26.0 is compatible. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net10.0-windows10.0.19041 is compatible. net11.0 is compatible. net11.0-android37.0 is compatible. net11.0-ios27.2 is compatible. net11.0-maccatalyst27.2 is compatible. net11.0-windows10.0.19041 is compatible. |
-
net10.0
- Microsoft.Maui.Controls (>= 10.0.110)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net10.0-android36.0
- Microsoft.Maui.Controls (>= 10.0.110)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net10.0-ios26.0
- Microsoft.Maui.Controls (>= 10.0.110)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net10.0-maccatalyst26.0
- Microsoft.Maui.Controls (>= 10.0.110)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net10.0-windows10.0.19041
- Microsoft.Maui.Controls (>= 10.0.110)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net11.0
- Microsoft.Maui.Controls (>= 11.0.0)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net11.0-android37.0
- Microsoft.Maui.Controls (>= 11.0.0)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net11.0-ios27.2
- Microsoft.Maui.Controls (>= 11.0.0)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net11.0-maccatalyst27.2
- Microsoft.Maui.Controls (>= 11.0.0)
- Syncfusion.Maui.Core (>= 35.1.46)
-
net11.0-windows10.0.19041
- Microsoft.Maui.Controls (>= 11.0.0)
- Syncfusion.Maui.Core (>= 35.1.46)
NuGet packages (19)
Showing the top 5 NuGet packages that depend on Syncfusion.Maui.Buttons:
| Package | Downloads |
|---|---|
|
Syncfusion.Maui.Inputs
This package provides the functionality to utilize the features of Syncfusion® Maui Inputs control and more. |
|
|
Syncfusion.Maui.PdfViewer
This package contains the Syncfusion® PDF Viewer component to view PDF files in .NET MAUI applications. |
|
|
Syncfusion.Maui.DataGrid
This package provides the functionality to utilize the features of Syncfusion® Maui DataGrid control and more. |
|
|
Syncfusion.Maui.Scheduler
This package provides the functionality to utilize the features of Syncfusion® Maui Scheduler control and more. |
|
|
Syncfusion.Maui.TreeView
This package provides the functionality to utilize the features of Syncfusion® Maui TreeView control and more. |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Syncfusion.Maui.Buttons:
| Repository | Stars |
|---|---|
|
syncfusion/maui-demos
This repository contains the Syncfusion .NET MAUI control’s samples and the guide to use them
|
| Version | Downloads | Last Updated |
|---|---|---|
| 35.1.46 | 464 | 11/11/2026 |
| 35.1.43 | 2,599 | 11/2/2026 |
| 35.1.42 | 3,109 | 10/27/2026 |
| 35.1.41 | 3,925 | 10/20/2026 |
| 35.1.40 | 3,716 | 10/13/2026 |
| 35.1.39 | 3,317 | 10/6/2026 |
| 35.1.37 | 6,895 | 9/29/2026 |
| 34.2.9 | 7,313 | 9/21/2026 |
| 34.2.8 | 8,948 | 9/14/2026 |
| 34.2.7 | 2,870 | 9/8/2026 |
| 34.2.6 | 3,459 | 8/31/2026 |
| 34.2.5 | 4,360 | 8/25/2026 |
| 34.2.4 | 5,567 | 8/17/2026 |
| 34.2.3 | 3,886 | 8/11/2026 |
| 34.2.2 | 4,556 | 8/5/2026 |
| 34.1.33 | 5,297 | 7/27/2026 |
| 34.1.32 | 7,998 | 7/21/2026 |
| 34.1.31 | 8,008 | 7/14/2026 |
| 34.1.30 | 3,522 | 7/9/2026 |
| 34.1.29 | 4,997 | 7/6/2026 |