skip to Main Content

User meta tokens

Overview

Sometimes you may want to use some specific user data in an action that’s not readily available via the tokens in the recipe’s triggers.  Here are a few example scenarios:

  • When a user submits a form, include some of their profile information in a webhook sent to an external system (or Zapier, or Google Sheets) along with the form data.
  • When a user completes a course, send an email to that user’s manager, whose email address is stored in a custom user metadata key manager_email.
  • When a user purchases a product (in WooCommerce, Easy Digital Downloads, etc.) generate a and email certificate that contains their personal information stored in user meta.

User meta data

User meta data is stored in key-value pairs.  When you want to find user meta data, you look up the value by specifying the corresponding key.  For example, if first_name is a key, the corresponding value could be Ken.  When using user meta data in Automator actions, you’ll specify the key and Automator will retrieve the corresponding value.

Using user meta data in actions

To use user meta data in actions, you’ll need to insert a User meta key token.  You can find the User meta key token in the tokens menu:

This token is different from other tokens because after it is inserted, you need to manually change the KEY parameter to specify the data you want.

When you insert the token, you’ll see this text:

{{USERMETA:KEY}}

You need to replace KEY with the user meta key that you want to retrieve the corresponding value of.  So, to retrieve the value of the manager_email key from the example above, you would enter:

{{USERMETA:manager_email}}

This will output the value associated with the user meta key manager_email.

The user meta key is a really powerful token that lets you retrieve any custom user meta data for use in your recipes. We’re working on making it even easier to use user meta data in Automator actions.  Stay tuned!

Back To Top