Skip to content

syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-avatar-view

syncfusion-wpf-avatar-view

Verified

Implement Syncfusion WPF SfAvatarView for displaying user profile avatars and initials. Use this when working with avatar controls, user profile displays, group avatars, or badge integration in WPF. Covers all content types (Default, Initials, CustomImage, AvatarCharacter, Group, ContentTemplate), visual styles (Circle, Square, custom shape/size), appearance customization, and SfBadge integration.

references/getting-started.md

View on GitHub
# Getting Started with SfAvatarView (WPF)

## Installation

Install via NuGet Package Manager:

```
Syncfusion.Shared.WPF
```

Or via Package Manager Console:

```powershell
Install-Package Syncfusion.Shared.WPF
```

## Assembly Reference

Add the following assembly to your project:

```
Syncfusion.Shared.WPF.dll
```

## XAML Namespace

Declare the Syncfusion namespace in your Window or UserControl:

```xml
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
```

## Minimal Working Example

The simplest avatar — uses `Default` content type with no configuration needed:

```xml
<Window xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
    <Grid>
        <syncfusion:SfAvatarView />
    </Grid>
</Window>
```

This renders a pre-built Avatar1 character in Circle shape at Small size.

## Quick Start: Display a Profile Image

Use `ContentType="CustomImage"` with a local asset:

```xml
<syncfusion:SfAvatarView ContentType="CustomImage"
                         AvatarShape="Circle"
                         AvatarSize="Large"
                         ImageSource="pack://application:,,,/Assets/profile.png" />
```

**Code-behind equivalent:**

```csharp
SfAvatarView avatarView = new SfAvatarView
{
    ContentType = AvatarContentType.CustomImage,
    AvatarShape = AvatarShape.Circle,
    AvatarSize = AvatarSize.Large,
    ImageSource = new BitmapImage(new Uri("pack://application:,,,/Assets/profile.png"))
};
grid.Children.Add(avatarView);
```

## Quick Start: Display Initials

When no image is available, show initials from a name:

```xml
<syncfusion:SfAvatarView ContentType="Initials"
                         AvatarName="Alex Johnson"
                         InitialsType="DoubleCharacter"
                         AvatarShape="Circle"
                         AvatarSize="Large" />
```

Renders "AJ" inside the avatar circle.

## Required Namespaces (Code-Behind)

```csharp
using Syncfusion.Windows.Shared;
```

## Common Setup Mistakes

- **Missing XAML namespace** — ensure `xmlns:syncfusion="http://schemas.syncfusion.com/wpf"` is declared
- **Image not showing** — verify the `pack://application:,,,/` URI is correct and image Build Action is `Resource`
- **Default avatar renders as blank** — `Default` type always shows Avatar1; if blank, check assembly reference
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall