Add an Update Profile Property Action to a Flow

Last updated at:


The Update Profile Property flow action allows you to collect and track profile data as people move through flows.

This flow action allows you to:

  • Update an existing profile property
  • Remove an existing profile property
  • Create and set a new profile property

Add the Update Profile Property Action


The Update Profile Property flow action can be placed on any path in a flow series. Once you add this action, it will be in draft by default. There are three ways you can use this action to update profiles:

  1. Update Existing Property
    This option allows you to update the value of an existing custom property. If the property you select is a list of values, you can choose to add or remove a value from the list. If the property doesn’t yet exist for a recipient profile, the property will first be created and then the value will be updated.

    Klaviyo automatically detects and validates the data type of the property you choose. For example, if you have a property like "Age" and all the existing values are numbers, then you try to update the value to "tom" we'll display an error because "tom" is not a number.

  2. Remove Profile Property
    The option allows you to remove an existing custom property from a profile. This will not only clear a value, but fully remove the property from the profile

  3. Create Profile Property
    This option allows you to create a brand new custom property and assign the value. If the property already exists for a given recipient profile, we’ll update the value. Here, you can also configure the data type for the new property:
    • TextThis is any regular string of text, like "Tom" or "Chocolate."
    • NumberThis is any numeric value, like 0, 5, or 750.
    • List:  This is a list of values, and we'll let you input all the values you want to be part of your new list.
    • Boolean: A boolean is a binary variable, having two possible values, “true” and “false." You can select true or false from a dropdown.

In some cases, you may want to enact several different profiles updates at once. Within a single action, you can add as many steps as you’d like. Steps will by default occur in the order you add them in, but you can re-order steps by dragging them.

This flow action can only be used to update custom properties associated with a profile. It's not currently possible to create, update, or remove special Klaviyo-reserved properties (like email address) using this feature.

View Activity

You can see a summary of who is waiting and who has moved through this step in the lefthand panel.


If you click View All Activity, you will be able to see the following:

  • Who is scheduled and in Waiting
  • Who is in Needs Review (if the flow component is/was in manual mode)
  • Who has successfully moved through the component and is Completed
  • Who was Skipped due to failing the flow filters or otherwise no longer qualifying at send time

Update Profile Property Examples

You can tag profiles simply to indicate they’ve reached a certain stage in a flow or with information based on email engagement. Below are three use cases of this feature.

Collect Categories of Interest

The links someone clicks in an email can indicate both specific and general interests. Throughout a flow, you may feature products from different categories. At the end of a series, you can create a Split based on what categories or collections someone clicked. Using the “Update Profile Property” action, create a Categories of Interest property and easily capture this engagement.

One example to consider is someone who clicks on "New Arrivals." This a good indicator this person is interested in the latest trends or new products. When launching a new product, send a specific campaign to those you know typically engage with new arrivals, with a subject line that plays to this theme.

Tag Profiles with Important Dates

Another great way to use this feature is to take advantage of the built-in method to set or update a property as the current date. If you have a New Customer Thank You series that is triggered when someone makes their first purchase, add the “Update Profile Property” action as a first step to tag each profile with a first purchase date.


Having certain dates stored can come in handy for further analysis as well as triggering date-based automation

Tag Profiles When They Complete a Welcome Series

You may not want subscribers to start receiving regular newsletter content until they've gone through your entire welcome series.

At the end of a welcome series flow, add a completed welcome flow property with the value "true." You can then segment your main subscriber list to only include those that have this property set to true.


Was this article helpful?
100 out of 153 found this helpful