# Working with Attributes ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/courses/personalize-foundations/working-with-attributes | | **course_slug** | personalize-foundations | | **lesson_slug** | working-with-attributes | | **markdown_file_url** | /academy/md/courses/personalize-foundations/working-with-attributes.md | | **generated_at** | 2026-04-28T06:55:48.574Z | > Part of **[Personalize Foundations](https://www.contentstack.com/academy/courses/personalize-foundations)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Video details #### At a glance - **Title:** Working With Attributes - **Duration:** 2m 42s - **Media link:** https://cdn.jwplayer.com/previews/RcVjZyCA - **Publish date (unix):** 1727659471 #### Streaming renditions - application/vnd.apple.mpegurl - audio/mp4 · AAC Audio · 113668 kbps - video/mp4 · 180p · 180p · 175263 kbps - video/mp4 · 270p · 270p · 220411 kbps - video/mp4 · 360p · 360p · 260386 kbps - video/mp4 · 406p · 406p · 294806 kbps - video/mp4 · 540p · 540p · 410759 kbps - video/mp4 · 720p · 720p · 642371 kbps - video/mp4 · 1080p · 1080p · 1563618 kbps #### Timed text tracks (delivery) - **thumbnails:** `https://cdn.jwplayer.com/strips/RcVjZyCA-120.vtt` #### Transcript Attributes define key characteristics of your users and there's two types of attributes in Personalize. Preset attributes and custom attributes. Preset attributes are predefined user characteristics that represent common user traits across all visitors. Traits like country, region, and city give you the ability to offer content to specific users in a geography. For example, you might want to promote content for a local attraction in the city where the user is visiting from. If they're in New York City, you might want to showcase a tour of Manhattan, tickets to the Statue of Liberty, or dining reservations in Soho. By identifying these attributes, you can group users into distinct audience segments, allowing you to tailor content and deliver more personalized experiences. Custom attributes, on the other hand, are characteristics you define to improve audience targeting. They let you capture visitor details that preset attributes don't, allowing for more precise personalization. Once you've created a custom attribute, you'll need to collect data for it, which can be done using the Personalize Edge SDK or API, as well as tools like Google Tag Manager or custom data platform integrations. This flexibility helps you create specific user segments and delivers personalized experiences, boosting engagement and conversions. Let's take a look at how we can create a custom attribute. On the left-hand side, click the Attributes button to open the Attributes screen. Here, you'll see all the preset attributes we discussed a moment ago. Of course, our interest is in creating a new attribute, so we'll click that button in the top right-hand corner. Enter a name of Travel Type and an attribute key of Travel Underscore Type. Enter a description if you'd like, and then click Save. Once it's done saving, you'll see your custom attribute appear in the list. On the right side, under the Actions column, you can either edit the attribute, which will return you to the previous window where you could rename the attribute or the attribute key, and modify the description. The other option is to delete the attribute if you wish. Once you have your attributes set up, it's time to add them to an audience. #### Subtitles (WebVTT) ```webvtt WEBVTT 1 00:00:00.000 --> 00:00:05.520 Attributes define key characteristics of your users and there's two types of 2 00:00:05.520 --> 00:00:10.680 attributes in Personalize. Preset attributes and custom attributes. 3 00:00:10.680 --> 00:00:16.640 Preset attributes are predefined user characteristics that represent common 4 00:00:16.640 --> 00:00:23.360 user traits across all visitors. Traits like country, region, and city give you 5 00:00:23.360 --> 00:00:29.120 the ability to offer content to specific users in a geography. For example, you 6 00:00:29.120 --> 00:00:33.360 might want to promote content for a local attraction in the city where the 7 00:00:33.360 --> 00:00:38.720 user is visiting from. If they're in New York City, you might want to showcase a 8 00:00:38.720 --> 00:00:44.680 tour of Manhattan, tickets to the Statue of Liberty, or dining reservations in Soho. 9 00:00:44.680 --> 00:00:50.320 By identifying these attributes, you can group users into distinct audience 10 00:00:50.320 --> 00:00:55.400 segments, allowing you to tailor content and deliver more personalized 11 00:00:55.400 --> 00:01:01.280 experiences. Custom attributes, on the other hand, are characteristics you define 12 00:01:01.280 --> 00:01:07.360 to improve audience targeting. They let you capture visitor details that preset 13 00:01:07.360 --> 00:01:13.560 attributes don't, allowing for more precise personalization. Once you've 14 00:01:13.560 --> 00:01:18.320 created a custom attribute, you'll need to collect data for it, which can be done 15 00:01:18.320 --> 00:01:24.640 using the Personalize Edge SDK or API, as well as tools like Google Tag Manager or 16 00:01:24.680 --> 00:01:30.760 custom data platform integrations. This flexibility helps you create specific 17 00:01:30.760 --> 00:01:36.480 user segments and delivers personalized experiences, boosting engagement and 18 00:01:36.480 --> 00:01:42.860 conversions. Let's take a look at how we can create a custom attribute. On the 19 00:01:42.860 --> 00:01:47.240 left-hand side, click the Attributes button to open the 20 00:01:47.240 --> 00:01:51.960 Attributes screen. Here, you'll see all the preset attributes we discussed a 21 00:01:52.160 --> 00:01:57.880 moment ago. Of course, our interest is in creating a new attribute, so we'll click 22 00:01:57.880 --> 00:02:03.360 that button in the top right-hand corner. Enter a name of Travel Type and an 23 00:02:03.360 --> 00:02:08.400 attribute key of Travel Underscore Type. Enter a description if you'd like, and 24 00:02:08.400 --> 00:02:14.000 then click Save. Once it's done saving, you'll see your custom attribute appear 25 00:02:14.000 --> 00:02:18.920 in the list. On the right side, under the Actions column, you can either edit the 26 00:02:18.960 --> 00:02:23.040 attribute, which will return you to the previous window where you could rename 27 00:02:23.040 --> 00:02:28.680 the attribute or the attribute key, and modify the description. The other option 28 00:02:28.680 --> 00:02:33.880 is to delete the attribute if you wish. Once you have your attributes set up, 29 00:02:33.880 --> 00:02:38.640 it's time to add them to an audience. ``` ```transcript [00:00] Attributes define key characteristics of your users and there's two types of [00:05] attributes in Personalize. Preset attributes and custom attributes. [00:10] Preset attributes are predefined user characteristics that represent common [00:16] user traits across all visitors. Traits like country, region, and city give you [00:23] the ability to offer content to specific users in a geography. For example, you [00:29] might want to promote content for a local attraction in the city where the [00:33] user is visiting from. If they're in New York City, you might want to showcase a [00:38] tour of Manhattan, tickets to the Statue of Liberty, or dining reservations in Soho. [00:44] By identifying these attributes, you can group users into distinct audience [00:50] segments, allowing you to tailor content and deliver more personalized [00:55] experiences. Custom attributes, on the other hand, are characteristics you define [01:01] to improve audience targeting. They let you capture visitor details that preset [01:07] attributes don't, allowing for more precise personalization. Once you've [01:13] created a custom attribute, you'll need to collect data for it, which can be done [01:18] using the Personalize Edge SDK or API, as well as tools like Google Tag Manager or [01:24] custom data platform integrations. This flexibility helps you create specific [01:30] user segments and delivers personalized experiences, boosting engagement and [01:36] conversions. Let's take a look at how we can create a custom attribute. On the [01:42] left-hand side, click the Attributes button to open the [01:47] Attributes screen. Here, you'll see all the preset attributes we discussed a [01:52] moment ago. Of course, our interest is in creating a new attribute, so we'll click [01:57] that button in the top right-hand corner. Enter a name of Travel Type and an [02:03] attribute key of Travel Underscore Type. Enter a description if you'd like, and [02:08] then click Save. Once it's done saving, you'll see your custom attribute appear [02:14] in the list. On the right side, under the Actions column, you can either edit the [02:18] attribute, which will return you to the previous window where you could rename [02:23] the attribute or the attribute key, and modify the description. The other option [02:28] is to delete the attribute if you wish. Once you have your attributes set up, [02:33] it's time to add them to an audience. ``` #### Key takeaways - Connect **Working with Attributes** back to your stack configuration before moving to the next module. - Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment. - Re-read the delivery versus management boundary for anything you changed in the entry model. ## Supplement for indexing ### Content summary Working with Attributes. Working with Attributes in Personalize Foundations (personalize-foundations). ### Retrieval tags - Working - with - Attributes - personalize-foundations - lesson 03 - Working with Attributes - personalize-foundations lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "03" and topics: [Working, with, Attributes]. Parent course slug: personalize-foundations. Use asset_references URLs as thumbnail hints in search results when present. Never surface LMS quiz content or assessment answers from this file. ### Asset references | Label | URL | | --- | --- | | Video thumbnail: Working with Attributes | `https://cdn.jwplayer.com/v2/media/RcVjZyCA/poster.jpg?width=720` | ### External links | Label | URL | | --- | --- | | Contentstack Academy home | `https://www.contentstack.com/academy/` | | Training instance setup | `https://www.contentstack.com/academy/training-instance` | | Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` | | Contentstack documentation | `https://www.contentstack.com/docs/` |