---
title: "Profile Card"
url: /docs/en-us/resources/modules/profile-card
last_updated: 2026-06-11T23:11:59Z
description: "The Profile Card module lets players see more information about other players in an experience."
---

# Profile Card

It can be interesting to learn about other players. The **ProfileCard** [developer module](/docs/en-us/resources/modules.md) is a great way to see more information about others within an experience, from badges achieved to the player's favorite experiences.

## Module usage

### Installation

To use the **ProfileCard** module in an experience:

1. From Studio's **Window** menu or **Home** tab toolbar, open the [Toolbox](/docs/en-us/projects/assets/toolbox.md) and select the **Creator Store** tab.
2. Make sure the **Models** sorting is selected, then click the **See All** button for **Categories**.
3. Locate and click the **Packages** tile.
4. Locate the **Profile Card** module and click it, or drag-and-drop it into the 3D view.
5. In the [Explorer](/docs/en-us/studio/explorer.md) window, move the entire **ProfileCard** model into `Class.ReplicatedStorage`. Upon running the experience the module will begin running.

### Views

Profile cards have different views depending on whether you're viewing your own card or another player's card.

#### Your Card

When you first spawn into the experience, an icon appears over your character. Clicking the icon opens the profile card view. Once the card is closed, the icon disappears, but you can reopen the card at any time by clicking your character.

When viewing your own card, it appears as it would to another player, except placeholder text will appear for any blank inputs. Additionally, the status string is subject to **text filtering**, as any free text input should be.

_Card without custom status_

_Card with custom status_

_Entering a custom status_

_Attempt to enter invalid status_

#### Other Player's Card

Icons do not appear over other characters, but clicking on a character will open their profile card. The button in the upper-right corner of the card lets you quickly request that player as a friend.

Note that players under the age of 13 will only see the status message if it's appropriate for their age group.

_Card with custom status_

_Card without custom status_

## API reference

### Functions

#### configure

_ configure(config: `Library.table`)_

Overrides default configuration options through the following keys/values in the `config` table. This function should be called from a `Class.LocalScript` within **StarterPlayerScripts**.

| Key | Description | Default |
| --- | --- | --- |
| `alwaysOnTop` | If `true`, shows locator icons on top of everything, preventing them from being blocked by 3D world objects. | true |
| `showPersonalIndicator` | If `true`, shows the personal indicator when a player first joins the experience. | true |
| `showBlur` | If `true`, shows the blurry screen background when a player enters edit mode. | true |
| `maxClickDistance` | Maximum distance from the camera viewpoint a card will appear when a character is clicked, measured in studs. | 100 |
| `backgroundColor` | Background color for the card (`Datatype.Color3`). | [228, 255, 255] |
| `backgroundTransparency` | Transparency of the card's `backgroundColor`. | 0.2 |
| `isScaled` | If `true`, automatically scales the size of the text to fill the height of the space. | false |
| `isTruncated` | If `true`, automatically hides the ends of strings that would otherwise be too long for proper viewing. | true |
| `hasRoundedCorners` | If `true`, the card's corners will be rounded. | false |
| `cornerRadiusValue` | Value of the `Class.UICorner` corner radius, if `hasRoundedCorners` is `true`. | 20 |
| `hasBorder` | If `true`, shows a border for the card. | false |
| `borderColor` | Color of the card's border (`Datatype.Color3`). Only applies if `hasBorder` is `true`. | [228, 255, 255] |
| `borderThickness` | Thickness of the card's border, if `hasBorder` is `true`. | 3 |
| `borderTransparency` | Transparency of the card's border, if `hasBorder` is `true`. | 0 |
| `borderLineJoinMode` | Corner style of the card's border (`Enum.LineJoinMode`). Only applies if `hasBorder` is `true`. | `Enum.LineJoinMode\|Round` |
| `headerFontSize` | Font size for the card's header. | 18 |
| `headerFontType` | Font type for the card's header (`Enum.Font`). | `Enum.Font\|GothamBlack` |
| `textFontSize` | Font size for the card's body text. | 15 |
| `textFontType` | Font type for the card's body text (`Enum.Font`). | `Enum.Font\|GothamMedium` |

```lua
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local ProfileCard = require(ReplicatedStorage.ProfileCard)

ProfileCard.configure({
	alwaysOnTop = true,
	maxClickDistance = 50,
	backgroundColor = Color3.fromRGB(0, 0, 0),
	backgroundTransparency = 0.4
})
```