Syncfusion.Maui.Carousel 35.1.46

Prefix Reserved
dotnet add package Syncfusion.Maui.Carousel --version 35.1.46
                    
NuGet\Install-Package Syncfusion.Maui.Carousel -Version 35.1.46
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Syncfusion.Maui.Carousel" Version="35.1.46" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Syncfusion.Maui.Carousel" Version="35.1.46" />
                    
Directory.Packages.props
<PackageReference Include="Syncfusion.Maui.Carousel" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Syncfusion.Maui.Carousel --version 35.1.46
                    
#r "nuget: Syncfusion.Maui.Carousel, 35.1.46"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Syncfusion.Maui.Carousel@35.1.46
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Syncfusion.Maui.Carousel&version=35.1.46
                    
Install as a Cake Addin
#tool nuget:?package=Syncfusion.Maui.Carousel&version=35.1.46
                    
Install as a Cake Tool

The Syncfusion .NET MAUI Carousel control allows users to navigate through image data in an interactive way so that it can be viewed or selected. It provides a rich, gallery-like browsing experience with various customization options for item arrangements, and it works across Android, iOS, macOS, and Windows from a single codebase.

Documentation · Getting Started · API Reference · Demos on GitHub · Product Page · Release Notes

.NET MAUI Carousel


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

Key features

Data binding and item layout

  • Bind to any IEnumerable<object> collection, including ObservableCollection<T>.
  • Populate items from images using SfCarouselItem, or render any custom view per item with the ItemTemplate property.
  • Two item arrangements: Linear and Default, through the ViewMode property.

Customization

  • Item size: control item dimensions with ItemWidth and ItemHeight.
  • Spacing: set the gap between items using ItemSpacing.
  • Rotation: adjust the rotation of items in linear mode using RotationAngle.
  • Scaling: display the selected and unselected items in different sizes using ScaleOffset.
  • Positioning: place the selected item anywhere in the viewport using SelectedItemOffset.
  • Animation speed: control how long a transition takes using Duration.

Interaction

  • Swipe to navigate through items, moving either one item or multiple items at a time, using the SwipeMovementMode property.
  • Enable or disable user interaction with EnableInteraction.
  • Track or set the current item using SelectedIndex.

Performance

  • Load more items on demand using the AllowLoadMore, LoadMoreItemsCount, and LoadMoreView properties.

Supported platforms

Platform Target framework
Android net10.0-android, net11.0-android
iOS net10.0-ios, net11.0-ios
macOS (Mac Catalyst) net10.0-maccatalyst, net11.0-maccatalyst
Windows net10.0-windows10.0.19041, net11.0-windows10.0.19041

Minimum OS versions follow the .NET MAUI supported platforms.


Installation

.NET CLI

dotnet add package Syncfusion.Maui.Carousel

Package Manager Console

Install-Package Syncfusion.Maui.Carousel

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. Create a model and a ViewModel

using System.Collections.ObjectModel;
using Syncfusion.Maui.Carousel;

public class CarouselModel
{
    public string ImageName { get; set; }
}

public class CarouselViewModel
{
    public ObservableCollection<CarouselModel> CarouselItems { get; set; }

    public CarouselViewModel()
    {
        CarouselItems = new ObservableCollection<CarouselModel>
        {
            new CarouselModel { ImageName = "image1.png" },
            new CarouselModel { ImageName = "image2.png" },
            new CarouselModel { ImageName = "image3.png" }
        };
    }
}

3. Add SfCarousel 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.Carousel;assembly=Syncfusion.Maui.Carousel"
             xmlns:local="clr-namespace:YourAppNamespace"
             x:Class="YourAppNamespace.MainPage">

    <ContentPage.BindingContext>
        <local:CarouselViewModel />
    </ContentPage.BindingContext>

    <syncfusion:SfCarousel ItemsSource="{Binding CarouselItems}"
                           ItemWidth="200"
                           ItemHeight="200">
        <syncfusion:SfCarousel.ItemTemplate>
            <DataTemplate>
                <Image Source="{Binding ImageName}" Aspect="AspectFit" />
            </DataTemplate>
        </syncfusion:SfCarousel.ItemTemplate>
    </syncfusion:SfCarousel>

</ContentPage>

Run the app and swipe to navigate through the carousel items.


Common scenarios

Customize the item arrangement

<syncfusion:SfCarousel ItemsSource="{Binding CarouselItems}"
                       ViewMode="Default"
                       RotationAngle="45"
                       Offset="60"
                       ScaleOffset="0.8"
                       SelectedItemOffset="0"
                       ItemSpacing="12" />

Show a load-more view

<syncfusion:SfCarousel ItemsSource="{Binding CarouselItems}"
                       AllowLoadMore="True"
                       LoadMoreItemsCount="3">
    <syncfusion:SfCarousel.LoadMoreView>
        <Button Text="Load more" />
    </syncfusion:SfCarousel.LoadMoreView>
</syncfusion:SfCarousel>

For more features, see the Carousel documentation.


Dependencies

Installing this package also installs the following packages:

  • Microsoft.Maui.Controls
  • Syncfusion.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


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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Syncfusion.Maui.Carousel:

Package Downloads
VertiGIS.Mobile

Create VertiGIS Mobile apps for Android, iOS, and UWP. Extend your apps with custom components, operations and services.

SharedMauiXamlStylesLibrary.Syncfusion

A collection of predefined Control styles for MAUI and Syncfusion.

Syncfusion.Maui.A2UI

This package provides the functionality to utilize the features of Syncfusion® .Net Maui A2UI controls and more.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Syncfusion.Maui.Carousel:

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 131 11/11/2026
35.1.43 394 11/2/2026
35.1.42 248 10/27/2026
35.1.41 568 10/20/2026
35.1.40 450 10/13/2026
35.1.39 297 10/6/2026
35.1.37 676 9/29/2026
34.2.9 826 9/21/2026
34.2.8 250 9/14/2026
34.2.7 377 9/8/2026
34.2.6 376 8/31/2026
34.2.5 633 8/25/2026
34.2.4 491 8/17/2026
34.2.3 477 8/11/2026
34.2.2 413 8/5/2026
34.1.33 1,472 7/27/2026
34.1.32 1,403 7/21/2026
34.1.31 414 7/14/2026
34.1.30 230 7/9/2026
34.1.29 724 7/6/2026
Loading failed