To request access to the custom objects functionality, submit this form.
You will learn
Learn about custom objects, including how to set up an object and how you can use objects across Klaviyo.
What are custom objects?What are custom objects?
Custom objects are a type of data structure in Klaviyo that enable you to map diverse, multi-relational data concepts into Klaviyo that can’t be stored using profile properties. For example, say you want to store data about customers’ pets in Klaviyo. Each pet has a number of attributes about it (e.g., name, age, breed. etc.) making it challenging to store this information with profile properties when a profile has multiple pets.
You can then use this object data in flows, templates, and segments across Klaviyo to better personalize your marketing.
Example use casesExample use cases
Below are some examples that demonstrate how custom objects are flexible in the data you can store in Klaviyo.
AppointmentAppointment
If you are a business where customers can schedule appointments, you can use an Appointment object to store appointment data for profiles.
Within each object record for the Appointment object, some examples of data you may want to include are:
- Appointment ID
- Appointment date
- Appointment person (e.g., specific doctor, instructor, etc.)
- Appointment location
- Appointment type
Profiles can have multiple object records if they have multiple appointments, and you can use this object data to create segments and send personalized messages and flows.
SubscriptionSubscription
If you are a business where customers can sign up for a subscription, you can use a Subscription object to store subscription data for profiles.
Within each object record for the Subscription object, some examples of data you may want include are:
- Subscription ID
- Subscription product
- Subscription price
- Subscription status
- Next billing date
Profiles can have multiple object records if they have multiple subscriptions, and you can use this object data to create segments and send personalized messages and flows.
ReservationReservation
If you are a business where customers can book reservations, you can use a Reservation object to store reservation data for profiles.
Within each object record for the Reservation object, some examples of data you may want include are:
- Reservation ID
- Reservation date
- Reservation location
- Reservation occasion
- Reservation guest count
Profiles can have multiple object records if they have multiple reservations, and you can use this object data to create segments and send personalized messages and flows.
PetPet
If you are a business that serves pet owners, you can use a Pet object to store data about profiles’ pets.
Within each object record for the Pet object, some examples of data you may want include are:
- Pet microchip ID
- Pet name
- Pet type (e.g., dog or cat)
- Pet breed
- Pet birthday
Profiles can have multiple object records if they have multiple pets, and you can use this object data to create segments and send personalized messages and flows.
Account limitsAccount limits
Custom objects have 3 sets of account limits:
-
Object limit
Total number of objects that an account can have. -
Object property limits
The number of properties an account can have per object.
-
Object record limits
The number of object records allowed for an account.
The object limits for your account depend on your account's profile limits and whether you have an Advanced KDP plan.
If you are on an Advanced KDP plan, the object record multiplier will be based on the total number of profiles on your account. If you just have an email plan, this multiplier will be based on the active profile limit for your account.
Profiles | Advanced KDP plan | Number of objects | Number of object properties | Object record multiplier |
Free plan | none | 0 | 0 | N/A |
paid | 5 | 30 | 10x | |
250 - 400,000 | none | 1 | 15 | 10x |
paid | 5 | 30 | 10x | |
Over 400,000 | none | 10x | ||
paid | 10x |
Additionally, all accounts have the following limits:
- Maximum of 500 records per profile per object.
- Object properties cannot be larger than 8kb.
Create an object
To create an object in Klaviyo, reach out to your customer success manager for assistance after sending the data source to Klaviyo through the objects API.
Objects on profile pagesObjects on profile pages
Relevant objects will also appear on a profile page so you can view the object records that pertain to a profile. To view the object records, navigate to the Objects tab on a profile page. You can switch between objects using the dropdown menu above the object cards.
To view a full object record, select the 3 dot menu and click View. A side panel will appear that contains the full object record.
Additional resources
How to use custom objects in templates