Home Features Explained How to Create and Use Custom Attributes

How to Create and Use Custom Attributes

Last updated on Apr 18, 2025

In Akece, you can track additional information about your contacts and conversations using custom attributes. These attributes allow you to record data beyond the default fields (like name, email, and location), enabling more personalized and efficient customer support.

Common Use Cases

You can use custom attributes to store information such as:

  • Subscription plan

  • Signup date

  • Most purchased product

  • Last order link

  • Account status

  • Date of last transaction

This information helps you better understand your customers and segment your contact base more effectively.

How to Create a Custom Attribute

  1. Go to Settings → Custom Attributes

  2. Click Add Custom Attribute

  3. Fill in the fields in the modal that appears:

  • Applies to: choose whether the attribute will be used for Conversations or Contacts

  • Display name: the visible name of the attribute

  • Key: unique identifier (e.g., subscription_plan)

  • Description: a short explanation of the attribute's purpose

  • Type: choose from Text, Number, Link, Date, List, or Checkbox

  1. Click Create

⚠️ Note: Each key must be unique. You cannot create two attributes with the same key.

How to Add Custom Attributes to Conversations

  1. Open a conversation in your Akece dashboard

  2. In the right-hand sidebar, locate the Conversation Info section

  3. Click + Add Attributes

  4. Select an existing attribute or click Create new attribute to add one directly

  5. Enter the value according to the selected type (e.g., text, checkbox, date, etc.)

You can edit, copy, or delete attributes by hovering over them.

How to Add Custom Attributes to Contacts

You can add custom attributes to contacts in two ways:

1. Through the Dashboard Sidebar

  • Open the contact’s conversation in the Akece panel

  • In the right-hand sidebar, locate the Contact Attributes section

  • Click + Add Attributes and select the desired attribute

  • Enter the corresponding value

2. Using the SDK on Your Website

You can also assign custom attributes via the Akece widget on your website:

window.$akece.setCustomAttributes({
  subscription_plan: "Premium",
  signup_date: "2024-03-01"
});

To remove an attribute:

window.$akece.deleteCustomAttribute("subscription_plan");

✅ Make sure that the value type (text, number, date, etc.) matches the attribute configuration.

If you need help configuring your custom attributes, feel free to reach out to our team:
📩 [email protected] | 📱 @akece.ai