---
title: "Add Custom User Attributes"
slug: "add-custom-user-attributes"
description: "This article covers how to use custom user attributes in web templates."
updated: 2026-07-09T14:27:24Z
published: 2026-07-09T14:27:24Z
canonical: "academy.insiderone.com/add-custom-user-attributes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Custom User Attributes

Custom User Attributes let you personalize templates by dynamically inserting user-specific data. This ensures your messages feel relevant and tailored to each recipient.

> [!NOTE]
> Before using Custom User Attributes, your [Custom User Attribute](https://academy.useinsider.com/docs/attributes-events-page) must be defined in String and Number Types.

> [!NOTE]
> Custom user attributes marked as PII are not shown in the dynamic content picker and cannot be selected for Web Templates. If an attribute you expect to use is missing, check its PII status under [Attributes and Events](/v1/docs/attributes-events-page).

## How to use custom user attributes

1. Insert dynamic attributes into your text by typing “@” in the text area.
2. A dropdown list of available attributes will appear, and you can select the one you need.![](https://cdn.document360.io/c6df4583-da94-4cb2-bb8a-be0cbdd11109/Images/Documentation/image-4SLTIJYF.png)

## Example Scenario

Assume that you have a **c_preferred_store** attribute defined:

- **Message template**: “Don’t forget to check out the new arrivals at your favorite store: @c_preferred_store.”
- **What the user sees**: “Don’t forget to check out the new arrivals at your favorite store: Downtown Mall.”

This way, each user gets a message personalized with their saved preferred store.

> [!NOTE]
> Using Custom User Attributes is currently unavailable in [Eureka](/docs/eureka-overview), [InStory](/docs/instory-overview), [Smart Recommender](/docs/smart-recommender-overview), and [Messaging](https://academy.useinsider.com/docs/messaging-overview) channels.

## Related

- [Create a Custom Attribute](/create-a-custom-attribute.md)
- [Design a Web Template](/design-a-web-template.md)