Back to Blog Posts

User schemas Understanding User Schemas in Embed Workflow: A Complete Guide

Ricardo Valdivieso
Dec 10, 2024

Understanding User Schemas in Embed Workflow: A Complete Guide

When building powerful workflow automation, data is king. That’s where user schemas in Embed Workflow come into play – they’re the foundation that makes your workflows truly dynamic and personalized. In this guide, we’ll explore how to harness user schemas to create more sophisticated workflow possibilities for your users.

What Are User Schemas?

User schemas define the structure of user-related data that will be available in your workflow builder. Think of them as a blueprint that tells Embed Workflow what information about your users can be accessed when creating workflows. This could include everything from basic profile information to complex usage metrics.

Setting Up User Schemas

Setting up user schemas is straightforward. Here’s how to get started:

  1. Navigate to Account Settings
  2. Access the Users section
  3. Find the User Schema configuration panel

Trigger settings

Supported Data Types

When creating schemas, you’ll have access to various data types:

  • String: Perfect for text data like names, addresses, or unique identifiers
  • Date: Handles temporal data such as registration dates or renewal timestamps
  • Boolean: Manages true/false flags like premium status or feature access
  • Integer: Stores whole numbers such as login count or points
  • Float: Handles decimal numbers like account balances
  • List: Manages collections of values such as permissions or preferences

Trigger settings

Creating Your First User Schema

Let’s walk through a practical example. Imagine you want to create workflows that handle different user tiers in your application.

  1. Click the “Add New” button
  2. Configure Fields
    • Set the data type to “Boolean”
    • Name it “is_premium”
    • Save your changes

Trigger settings

Verify Schema Creation

Now your users can access this data in their workflows using {{user.is_premium}}.

Best Practices for User Schemas

To make the most of your user schemas, keep these tips in mind:

  • Be Selective: Only include data that’s actually useful for workflows. More isn’t always better.
  • Use Clear Names: Choose descriptive variable names that make sense to your users.
  • Think Ahead: Consider what conditions your users might want to create in their workflows.
  • Stay Organized: Group related fields logically to make them easier to find and use.

Getting Started

Ready to implement user schemas in your application? Here’s your action plan:

  1. Identify the key user data points that would be valuable in workflows
  2. Map out your schema structure using the available data types
  3. Implement the schemas through the Account Settings interface
  4. Test your schemas by creating sample workflows that utilize the new data

Ready to Embed?

Try today for free. Credit card is not required.

Sign up for free