> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/dynamic-components/components/profile-card.md).

# Profile Card

## Overview

The Avonni Profile Card displays a user or entity profile in a visually rich card layout. It combines a title and subtitle, a customizable background image, and an optional avatar with flexible positioning so you can highlight profile information in a structured, engaging way.

The Profile Card has no data source. Configure its content, appearance and avatar position in the Properties panel.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fo90x0YerHof6VZImYZ3t%2Fprofile-card-anatomy.png?alt=media" alt="A Profile Card with a blue banner, a circular avatar over it, a title, a subtitle and two lines of body text"><figcaption><p>The four parts of a card: the <strong>Title</strong> and <strong>Subtitle</strong> over the <strong>Background Image</strong>, the avatar positioned against it, and whatever you drop into the card body.</p></figcaption></figure>

## Projects

See how Profile Card fits into a complete Salesforce workflow. Each project includes steps to build it with AI or manually.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4><a href="https://docs.avonnicomponents.com/projects/use-cases/record-pages/account-highlight-panel">Account Highlight Panel</a></h4></td><td>Add on to the highlight panel using Dynamic components and charts.</td><td data-object-fit="fill"><a href="https://3857391697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdHOej9Pd5IxJNGEJMZKW%2Fuploads%2FVnk5SIapyqT0Rrh78QgN%2Faccount-highlight-panel-cover.png?alt=media">https://3857391697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdHOej9Pd5IxJNGEJMZKW%2Fuploads%2FVnk5SIapyqT0Rrh78QgN%2Faccount-highlight-panel-cover.png?alt=media</a></td></tr></tbody></table>

## Configuration

To configure the Profile Card, select it on the canvas. The **Edit Profile Card** panel opens on the right with two tabs: **Properties** and **Style**. The sections below mirror the Properties tab.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FyhleAWm7caDg1zFZP7GW%2Fprofile-card-builder-properties.png?alt=media" alt="The Edit Profile Card panel showing the card settings, then the Avatar group with Image URL, Fallback Icon Name, Variant, Size and Position" width="320"><figcaption><p>The Properties tab: the card settings first, then the <strong>Avatar</strong> group. The three responsive positions sit behind <strong>Advanced Options</strong>.</p></figcaption></figure>

### Card

The first group controls the card's main content and its overall framing.

#### Title

The **Title** setting defines the heading shown at the top of the card. When you provide a title, the card's title slot will not appear directly in the canvas.

#### Subtitle

The **Subtitle** setting adds a line of text displayed under the title, useful for a role, location, or any secondary detail that supports the title.

#### Background Image

The **Background Image** setting lets you choose an image to display behind the card content. Use **Select Image** to pick a file; supported formats include APNG, AVIF, GIF, JPG, JPEG, PNG, SVG, and WEBP.

#### Content Pull Padding

The **Content Pull Padding** toggle, when enabled, adjusts the card's internal padding to visually pull the content closer to the edges of the card. It is off by default.

### Avatar

The **Avatar** group is collapsible and controls the optional avatar shown on the card, including its image, shape, size, and position.

#### Image URL

The **Image URL** setting points to the image used as the avatar. Use **Select Image** to choose a file; supported formats include APNG, AVIF, GIF, JPG, JPEG, PNG, SVG, and WEBP.

#### Fallback Icon Name

The **Fallback Icon Name** setting defines the Lightning Design System icon shown in place of the avatar when the image fails to load.

#### Variant

The **Variant** setting controls the shape of the avatar:

* **Circle** (default) — a rounded avatar.
* **Square** — a square avatar.

#### Size

The **Size** setting controls how large the avatar appears. Choose the option that best fits your card layout:

* **X-Small** — the smallest avatar.
* **Small** — a compact avatar.
* **Medium** (default) — the standard size, suitable for most cards.
* **Large** — a more prominent avatar.
* **X-Large** — the largest avatar.

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FLuvg8xfzGHqvt0Wo3qwF%2Fprofile-card-avatar-size.png?alt=media" alt="Five profile cards showing the avatar at x-small, small, medium, large and x-large"><figcaption><p>The five sizes. The card header shrinks as the avatar grows, so a long title truncates at <strong>Large</strong> and above.</p></figcaption></figure>

#### Position

The **Position** setting places the avatar relative to the card. Choose from:

* **Top Left** (default), **Top Center**, **Top Right**
* **Bottom Left**, **Bottom Center**, **Bottom Right**
* **Left**, **Center**, **Right**

<figure><img src="https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2FBbkbF3kdT0C591Li0yau%2Fprofile-card-avatar-position.png?alt=media" alt="Nine profile cards in a three by three grid, each with the avatar in one of the nine positions"><figcaption><p>The nine positions. The top row sits the avatar above the banner, the middle row centres it on the banner edge, and the bottom row drops it into the card body.</p></figcaption></figure>

#### Position on Small / Medium / Large Container

The three responsive position settings let the avatar move as the card's container grows wider, so the layout adapts to different screen sizes. They share the same options as **Position** and apply at progressively larger widths:

* **Position on Small Container** — applies when the component is 480px wide or more.
* **Position on Medium Container** — applies when the screen width is 768px or more.
* **Position on Large Container** — applies when the screen width is 1024px or more.

Leave a responsive position empty to keep the avatar where the base **Position** setting placed it.

The three responsive positions are grouped under **Advanced Options**, at the bottom of the **Avatar** section.

### Set Component Visibility

All components support conditional visibility — see [Component Visibility](https://docs.avonnicomponents.com/dynamic-components/core-concepts/component-visibility.md).

## Styling

Configure the Profile Card's appearance from the **Style** tab of the Edit Profile Card panel.

{% tabs %}
{% tab title="Margin" %}
Controls the *outer* spacing around the card.

* **Top / Right / Bottom / Left:** Adjust the space on each side.
  {% endtab %}

{% tab title="Padding" %}
Controls the *inner* spacing between the card's content and its border.

* **Top / Right / Bottom / Left:** Adjust the inner spacing on each side.
  {% endtab %}

{% tab title="Size" %}
Controls the card's dimensions.

* **Width / Height:** Set fixed dimensions.
* **Min Width / Max Width / Min Height / Max Height:** Constrain the size within bounds.
* **Overflow:** Control how content that exceeds the bounds is handled.
  {% endtab %}

{% tab title="Header" %}
Styles the card header (title and subtitle).

* **Background Color:** Set the header background.
* **Title Text Color / Title Font Size / Font Style / Font Weight / Font Family:** Style the title.
* **Subtitle Text Color / Subtitle Font Size / Font Style / Font Weight / Font Family:** Style the subtitle.
* **Border Bottom Size / Border Bottom Color:** Set the divider below the header.
  {% endtab %}

{% tab title="Background" %}
Sets the card body background.

* **Background Color:** Set the card background color.
  {% endtab %}

{% tab title="Border" %}
Customizes the card border.

* **Color / Size / Radius:** Set the border color, thickness, and corner rounding.
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/dynamic-components/components/profile-card.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
