Klaviyo How to Add Property Dimension

Custom properties in Klaviyo represent a powerful way to store additional information about your contacts, enabling personalized marketing strategies that drive real results. These properties act as data containers that hold specific details about your subscribers, ranging from demographic information like gender and size preferences to engagement metrics and purchase behaviors. Custom properties give you the flexibility to collect virtually any type of information about your customers, which you can later leverage to create highly targeted segments, personalize email content, or filter flows based on specific criteria.

What Are Custom Properties and Why Do They Matter?

Custom properties function as flexible data fields that extend beyond basic contact information like email addresses and names. They allow you to capture nuanced customer details that make your marketing campaigns more relevant and effective. For instance, if you run a clothing store, you might want to track your customers’ preferred styles, sizes, or color preferences to send them targeted product recommendations.

The beauty of custom properties lies in their versatility and unlimited potential. You can use them to record customer preferences regarding email frequency or content types, store responses from questionnaires, or track specific customer behaviors that matter to your business. If you operate a subscription-based service, you might track subscription tiers, renewal dates, or usage patterns to optimize your retention strategies.

Building Your Customer Data Foundation

Custom properties serve as the building blocks for sophisticated marketing automation. They transform generic email lists into rich customer databases filled with actionable insights. When you collect information about customer preferences, behaviors, and characteristics, you create opportunities for hyper-personalized marketing that resonates with individual subscribers.

The possibilities are endless when it comes to custom property applications. There’s no limit to the number of custom properties you can add to a profile, allowing for extensive personalization and segmentation capabilities that can significantly enhance your marketing efforts. This flexibility means you can adapt your data collection strategy as your business grows and evolves.

How to Add Custom Properties to Customer Profiles

Several effective methods exist for adding custom properties to your contacts’ profiles, each serving different business needs and scenarios. The most direct approach involves asking contacts to provide information through subscribe pages, signup forms, or third-party list growth integrations. When designing these touchpoints, any additional fields beyond the standard email address will be collected as custom properties.

These forms essentially function as strategic questionnaires, allowing you to gather valuable customer data that can later inform your segmentation and personalization strategies. The key is to balance data collection with user experience, ensuring you’re not overwhelming potential subscribers with too many fields while still capturing the information you need for effective marketing.

Essential Data Collection Methods

The most effective approaches for gathering custom property data include multiple touchpoints that capture different aspects of customer information:

• Signup forms and landing pages: Design forms that collect specific preferences, interests, or demographic information during the initial subscription process
• Post-purchase surveys: Implement questionnaires after transactions to gather feedback, product preferences, or satisfaction ratings
• Email preference centers: Create dedicated pages where subscribers can update their communication preferences, frequency settings, or content interests
• Interactive content: Use quizzes, polls, or assessments to collect detailed customer insights while providing value through personalized recommendations

CSV Upload Method for Bulk Data Import

Another powerful method involves uploading a CSV file with custom properties for bulk data management. When uploading a contact list, any column after the “Email” column can be used to attach custom properties to profiles. For example, you could include columns for gender, age range, purchase preferences, or any other relevant customer attributes.

If the property doesn’t yet exist in your Klaviyo account, you’ll need to create it during the upload process by typing the property name into the Klaviyo Field column and selecting the “Create” option. This process allows you to efficiently populate custom properties for large numbers of contacts simultaneously. During this process, avoid clicking “Subscribe to Email Marketing” in the import review step to ensure all profiles retain their existing subscription status.

Manual Property Addition for Individual Contacts

You can also manually add custom properties directly to individual contact profiles for more targeted data management. Simply navigate to the profile you want to modify, locate the “Custom Properties” section, and click “Add custom property.” This method proves particularly useful for adding properties to specific contacts or for testing how custom properties will display in your segments and flows.

Manual addition works well when you need to update specific customer information based on interactions, purchases, or support conversations. This approach gives you complete control over the data you’re adding and allows for immediate implementation without waiting for automated processes to trigger.

Leveraging Custom Properties for Advanced Segmentation

Once you’ve created custom properties and populated them with data, you can leverage them to create sophisticated segments that drive targeted marketing campaigns. Custom properties become available in the segment builder once they exist on at least one profile in your account. When creating segments, you can select “Properties about someone” to access your custom properties and build highly specific audience groups.

Effective segmentation strategies using custom properties can dramatically improve your email marketing performance. You can create segments based on virtually any customer attribute you’ve collected, from purchase history and product preferences to engagement levels and demographic information. This level of targeting ensures that your marketing communications remain relevant to each recipient, leading to higher open rates, click-through rates, and conversions.

High-Impact Segmentation Strategies

Strategic segmentation using custom properties enables precise targeting that drives measurable results across different customer groups:

• VIP customer segments: Target high-value customers with loyalty tier properties, total spend thresholds, or purchase frequency metrics for exclusive offers and premium experiences
• Product interest groups: Segment customers based on category preferences, brand affinities, or specific product interactions to deliver highly relevant product recommendations
• Lifecycle stage targeting: Create segments for new customers, active buyers, or lapsed customers to deliver appropriate messaging for each stage of the customer journey
• Geographic and demographic targeting: Use location, age, gender, or other demographic properties to customize messaging for specific audience characteristics

Flow Optimization with Property-Based Filtering

Custom properties offer powerful filtering capabilities for email flows and automation sequences. You can use them to determine who enters a flow or to create conditional splits within flows based on specific customer characteristics. For example, you might create a flow that only targets customers who have indicated a preference for a specific product category, ensuring maximum relevance.

Conditional splits within flows become incredibly sophisticated when powered by custom properties. You could set up a conditional split that sends different email content based on a customer’s indicated preferences, purchase history, or engagement level. This approach allows you to create personalized customer journeys that adapt to individual subscriber characteristics and behaviors.

Dynamic Content Personalization Techniques

Custom properties can be used to include dynamic content within emails using the “lookup” filter for enhanced personalization. For instance, if you’ve collected information about a customer’s hair color, you could personalize your email by including a line like “Your hair color is: {{ person|lookup:‘Hair Color’ }}.” When the email is sent, this placeholder will be automatically replaced with the recipient’s actual hair color value stored in their profile.

This type of personalization can significantly enhance engagement and conversion rates by making each communication feel tailored to the individual recipient. Dynamic content based on custom properties allows you to create emails that speak directly to customer interests, preferences, and past behaviors, creating a more engaging and relevant experience.

Creating List-Type Properties for Multiple Values

Klaviyo supports different data types for custom properties, including the powerful “list” data type that allows for complex data storage. A list property enables you to store multiple values within a single custom property, which proves extremely useful when you need to track multiple selections or preferences for a contact. For example, you might want to track all the product categories a customer has purchased from or all the topics they’re interested in receiving information about.

Creating list-type custom properties requires using the “Update Profile Property” action in a flow rather than standard form submissions. When setting up this action, you can choose to update an existing property and select the option to add a value to a list. If the property doesn’t yet exist for a particular profile, Klaviyo will first create the property and then add the value to the list.

Data Type Validation and Integrity

Klaviyo automatically detects and validates the data type of properties to maintain database integrity. For example, if you have a property like “Age” where all existing values are numbers, Klaviyo will display an error if you try to update it with a text value. This validation helps maintain data integrity across your custom properties, ensuring that your segmentation and personalization strategies work as expected.

Data type consistency becomes crucial as your custom property database grows. Maintaining proper data types ensures that your segments function correctly and that your personalization efforts deliver the intended results. This validation system prevents common errors that could compromise your marketing automation effectiveness.

Interactive Property Updates Through Email Links

Klaviyo offers a powerful feature that allows you to update profile properties when subscribers click on links or buttons in your emails. This capability opens up numerous possibilities for collecting information from your subscribers without requiring them to fill out forms. You could include buttons in your welcome email that allow subscribers to specify their interests, or add links in a newsletter that let users indicate how frequently they want to receive emails from you.

Implementing this functionality requires using the {% update_property_link %} tag in your email template. The syntax for this tag is: {% update_property_link 'profile_property' 'property_value' 'redirect_link' %}. Replace ‘profile_property’ with the name of the property you want to update, ‘property_value’ with the value you want to assign to that property, and ‘redirect_link’ with the URL you want to redirect the user to after they click the button.

Link-Based Update Limitations and Considerations

Several important limitations exist when using update property links that you should consider during implementation. When a subscriber clicks an update property link, it will overwrite any existing value for that property, including list-type properties. For list properties, the entire list will be overwritten, and it’s not possible to simply append a new item to an existing list using this method.

These links don’t support dynamic content or Unicode characters, and only standard URLs are supported as redirect links. UTM parameters are not supported for update property links, so if you need tracking, you’ll need to manually include UTM parameters in the redirect link. Planning around these limitations ensures your interactive email campaigns function as intended.

Building Dimension-Based Customer Segments

Dimensions in Klaviyo refer to the specific properties or attributes about your contacts that you can use to create segments for targeted marketing. These dimensions can be standard Klaviyo properties like email address or location, or they can be custom properties that you’ve created to capture specific customer information. Creating dimension-based segments allows you to target specific groups of customers based on their characteristics, behaviors, or preferences with precision.

Creating dimension-based segments involves navigating to the Lists & Segments page in Klaviyo and clicking “Create List / Segment.” Select “Segment” and then define the criteria for your segment based on the dimensions that matter most to your marketing goals. Under the “Definition” section, select “Properties about someone” and then choose the dimension (property) you want to use for segmentation.

Segment Criteria and Condition Setting

Setting up effective segment criteria requires careful consideration of the conditions and values you’re targeting. You can set conditions like equals, contains, greater than, or other logical operators depending on your segmentation needs. For example, you might create a segment of customers who have purchased more than three times, or customers whose preferred product category equals “electronics.”

One important consideration is that dimensions won’t appear in the dropdown menu until at least one profile in your account has that property. If you’re trying to create a segment based on a custom property that doesn’t yet exist on any profiles, you’ll need to first add that property to at least one profile through manual addition, CSV upload, or flow triggers.

Third-Party Integration and Data Synchronization

Klaviyo’s flexibility extends to integrating data from third-party sources as custom properties, significantly enhancing your segmentation capabilities beyond native data collection. Many apps and platforms that integrate with Klaviyo automatically push their data as custom properties to your contact profiles. Quiz apps like Octane AI can push quiz results and answers as custom properties, while loyalty platforms sync points and tier information directly to customer profiles.

Subscription management tools like Recharge or QPilot can share subscription metrics, renewal dates, and product preferences as custom properties. When integrating third-party data, these properties typically appear with a prefix indicating their source, such as “Octane: Quiz result” or “rc_” for Recharge properties. This naming convention helps you identify the source of different data points and organize your custom properties effectively.

Popular Third-Party Property Sources

Common integrations that enhance your custom property database include various platforms that automatically sync valuable customer data:

• Quiz and survey platforms: Tools like Octane AI, Typeform, or Jotform that capture customer preferences, product recommendations, or detailed profile information
• Loyalty and rewards programs: Platforms like Smile.io, LoyaltyLion, or Yotpo that track points, tier status, referral activity, and reward redemption history
• Subscription management tools: Services like Recharge, Bold Subscriptions, or Chargebee that provide subscription status, billing cycles, and product preferences
• Customer service platforms: Help desk tools like Zendesk or Gorgias that can share support ticket history, satisfaction ratings, or issue categories

Managing Third-Party Property Integration

Using third-party properties for segmentation follows the same process as any custom property within Klaviyo’s interface. Create a segment with “Properties about someone” as the condition, select the third-party property as your dimension, and set the appropriate filter criteria. This seamless integration allows you to leverage data from multiple platforms without complex technical implementations.

Like any custom property, third-party properties must exist on at least one profile before they’ll appear in your segment builder. If you’re setting up a new integration, you may need to wait for data to sync or manually trigger a test event before you can create segments based on that data. Some integrations offer the ability to backfill historical data, ensuring that all your existing customers have the relevant properties populated on their profiles.

Troubleshooting Property Dimension Challenges

Common issues arise when working with property dimensions, but most can be resolved with systematic troubleshooting approaches. One of the most frequent problems users face is not seeing their custom properties in the segment builder or flow filters. This typically occurs because the property doesn’t yet exist on any profile in your account, since Klaviyo only displays properties that are actually present on at least one profile.

Data type mismatches represent another common challenge that can disrupt your marketing automation. Klaviyo validates property values against the existing data type of the property, so attempting to update a numeric property with a text value or vice versa will result in errors. Similarly, date properties require consistent formatting (typically MM/DD/YYYY or YYYY-MM-DD) for Klaviyo to recognize them as valid dates.

Email Link Update Troubleshooting

When working with update property links in emails, several specific issues can arise that require targeted solutions. These links will overwrite existing values rather than append to them, which can cause data loss if not properly planned. If you need to maintain multiple values for a property, you’ll need to implement a different approach, such as using the “Update Profile Property” action in a flow with the option to add a value to a list.

Update property links have specific technical limitations that can affect functionality. UTM parameters are not supported for update property links, so tracking requires manual inclusion of UTM parameters in the redirect link. Additionally, these links don’t support dynamic content or Unicode characters, which can limit their application in certain marketing scenarios.

Advanced Custom Property Applications

Custom properties unlock sophisticated marketing strategies that can significantly enhance customer engagement and conversion rates beyond basic segmentation. One advanced application involves creating customer engagement tiers based on behavior patterns and interaction history. By tracking metrics like purchase frequency, average order value, or email engagement, you can assign tier values to profiles and tailor your marketing accordingly.

Top-tier customers might receive exclusive offers, early access to new products, or premium customer service experiences, while less engaged customers could receive reactivation campaigns designed to re-engage their interest. This tiered approach allows you to allocate marketing resources more effectively and provide differentiated experiences based on customer value.

Birthday and Anniversary Marketing Automation

Birthday emails represent another powerful application of custom properties that can drive significant revenue increases. By collecting birth dates and ensuring they’re formatted correctly as MM/DD/YYYY or YYYY-MM-DD, you can create segments of customers whose birthdays are today and trigger personalized birthday flows offering special discounts or gifts. Birthday emails typically have conversion rates five times higher than standard campaigns, making this simple implementation highly valuable.

Anniversary marketing extends this concept to track important dates like first purchase anniversaries, subscription start dates, or account creation dates. These milestone-based campaigns create emotional connections with customers and provide natural opportunities for special offers and personalized communications that feel meaningful rather than purely promotional.

Product Recommendation and Cross-Selling Strategies

E-commerce businesses can leverage custom properties to track product preferences and purchase history for sophisticated product recommendation engines. By recording categories, styles, or specific products a customer has shown interest in, you can create highly targeted cross-sell and upsell campaigns that feel natural and relevant. This approach moves beyond generic product recommendations to truly personalized suggestions based on individual customer behavior.

Subscription businesses can use custom properties to track subscription status, frequency preferences, and product selections to optimize renewal rates and reduce churn. By monitoring subscription health through custom properties, you can trigger timely interventions when customers show signs of disengagement or create upgrade campaigns when customers demonstrate increased usage patterns.

Maximize Your Klaviyo Custom Properties Today

Custom properties represent one of the most powerful features in Klaviyo for creating personalized, effective marketing campaigns that drive real business results. By implementing the strategies and techniques outlined in this guide, you can transform your basic email list into a sophisticated customer database that enables highly targeted marketing automation. The key to success lies in thoughtful planning, consistent implementation, and ongoing optimization based on performance data.

Start by identifying the most valuable customer information for your specific business model and begin collecting that data through the methods that work best for your audience. Whether you choose forms, CSV uploads, or automated integrations, focus on building a solid foundation of custom properties that will support your long-term marketing goals. As your database grows and evolves, continue to refine your approach based on what drives the best results for your unique customer base and business objectives.