Delete a Custom Attribute

Deleting a custom attribute from your Personalize project helps maintain an organized set of attributes and ensures that only relevant data is tracked.

This guide walks you through the steps required to delete non-referenced and referenced custom attributes from your project, allowing you to clean up unused or redundant attributes.

Prerequisites

• Contentstack account
• Access to the Contentstack Organization that has Personalize enabled
• Access to a project in Personalize

Note: Users with Owner and Member access to a Personalize project can delete existing custom attributes.

Steps for Execution

Note: For this guide, we have assumed that you have already created a Personalize project. If not, please follow this guide and create a project in Personalize.

Delete a Non-referenced Custom Attribute

A non-referenced attribute in Contentstack Personalize is a custom attribute that is not currently being used in any audience rules or segmentations within your project.

To delete an existing non-referenced custom attribute, log in to your Contentstack account and perform the following steps:

1. In the top navigation bar, click the App Switcher icon and then click Personalize.
2. You will be redirected to the Personalize Projects landing page. Click the project for which you want to delete a custom attribute.
3. Click the Attributes tab.
4. You can delete an existing custom attribute by clicking the corresponding vertical ellipses under the Actions section and selecting Delete.
   

    

5. In the Delete Attribute modal, click Delete to permanently delete the custom attribute.

You will get a success message after the custom attribute is deleted from Personalize.

Delete a Referenced Custom Attribute

A referenced attribute in Contentstack Personalize is a custom attribute that is currently being used in audience rules or segmentations within your project.

This means that the attribute is actively involved in defining the conditions or criteria for targeting specific audiences with personalized experiences.

As a result, deleting a referenced attribute requires additional steps to ensure that existing audience definitions and personalization strategies are not disrupted. This involves first removing the attribute from any audience rules where it is used, and then proceeding with its deletion.

To delete an existing referenced custom attribute, log in to your Contentstack account and perform the following steps:

1. In the top navigation bar, click the App Switcher icon and then click Personalize.
2. You will be redirected to the Personalize Projects landing page. Click the project for which you want to delete a custom attribute.
3. Click the Audiences tab.
4. To remove a referenced custom attribute from the Audience, open the audience in one of the following ways:
   • Click the audience name, or
   • Click the vertical ellipses under Actions and select Edit.
     

5. Note: To delete custom attributes from a referenced audience, ensure that the experience associated with that audience is in ‘Draft’ status.

6. In the Audience page, scroll to the Rules section and then click the Delete icon next to the preferred custom attribute from the list.
7. Once you have done that, click the Save button.
8. Now that we have removed the custom attribute from the Audience’s Rules, click the Attributes tab in the left navigation panel.
9. You can delete an existing custom attribute by clicking the corresponding vertical ellipses under the Actions section and selecting Delete.
   
10. In the Delete Attribute modal, click Delete to permanently delete the custom attribute.

    Warning: Deleting a custom attribute might affect the Audience segmentation, experience performance, and the data for that attribute will no longer be collected from that point onward.

You will get a success message after the custom attribute is deleted from Personalize.

Additional Resource: You can use the Personalize Management API to create, edit, delete, and retrieve all existing attributes.