Skip to main content

Merge Fields and Custom Variables in Kyrios

Merge fields and custom variables are placeholders that dynamically insert saved information into Kyrios messages, workflows, templates, websites, funnels, and payment or tracking links.

What Merge Fields Are

A merge field is a dynamic placeholder that pulls saved data into a message or template. A merge field usually looks like this:

{{contact.first_name}}

When the message is sent, Kyrios replaces the merge field with the saved value from the matching record. Example:

Hi {{contact.first_name}}! This is {{user.name}} from {{location.name}}.


Where Merge Fields Can Be Used

Merge fields can be used in areas where Kyrios supports dynamic personalization.

Common places include:

  1. SMS messages

  2. Email campaigns

  3. Email templates

  4. Workflows

  5. Websites

  6. Funnels

  7. Trigger links

  8. Payment links


What Happens When a Merge Field Is Empty

If a merge field has no saved value, Kyrios replaces it with a blank space. Kyrios does not currently support default or fallback values for empty merge fields.

Example: Hi {{contact.first_name}},

If the contact has no first name saved, the first name area appears blank.


Use Conditional Sending as a Workaround

Use Conditional Sending in the email builder when you need different content to show based on whether a field has data. Example setup:

  1. Create one content block that says Hi {{contact.first_name}},.

  2. Set that block to show only when First Name is not empty.

  3. Create another content block that says Hi Friend,.

  4. Set that block to show when First Name is empty.


Standard Fields

Standard fields are built-in fields available by default in Kyrios. Standard fields cannot be modified or deleted. Common standard fields include:

  1. Contact first name

  2. Contact email

  3. Contact phone

  4. Appointment date and time

  5. Assigned the user's full name

  6. Account name


Company Fields in Workflows

Contact-based workflows can use company fields in the variable picker. Company values only populate when the contact is associated with a company record. If the contact is not associated with a company record, the company merge field resolves as blank.


Custom Fields

Custom fields are user-defined fields that store unique data for contacts, opportunities, or supported objects. Use custom fields when the value changes from record to record. Examples include:

  1. Customer preference

  2. Membership level

  3. Product interest

  4. Event attendance

  5. Account manager

  6. Contract renewal date

  7. Lead source


Additional Workflow Fields in the Picker

Workflow merge fields can include built-in system fields in addition to saved custom values. Examples include:

  1. Contact Engagement Score

  2. Contact Attribution Medium ID

  3. Note created by name

  4. Task ID

Some fields only appear when the workflow has the correct context. For example, Task ID appears in task-related workflows.


Custom Values

Custom values are reusable placeholders for information that should stay consistent across multiple assets. Use custom values when the value is the same in many places and may need to be updated later. Examples include:

  1. Company phone number

  2. Company email address

  3. Website URL

  4. Standard closing text

  5. Compliance statement

  6. Brand tagline


Custom Objects

Custom objects are user-created data structures for storing advanced business information beyond standard contact fields. Use custom objects when you need to manage a separate type of record with its own fields. Examples include:

  1. Subscription plans

  2. Inventory records

  3. Property listings

  4. Vendor details

  5. Advanced appointment details


Trigger Links

Trigger links are special links used inside emails or SMS messages. When a contact clicks a trigger link, Kyrios can track the click and trigger workflow actions. Common uses include:

  1. Webinar registration

  2. Survey follow-up

  3. Content downloads

  4. Upsell offers

  5. Event invitations

  6. Special offers


Payment Links

Payment links allow customers to pay for a product, service, deposit, donation, ticket, or subscription from a shareable link. Use payment links when you need a fast way to collect payment without building a full checkout page.


Common Issues and Fixes

My merge field is showing blank

The matching record may not have a saved value for that field. Add the missing value to the contact, company, user, or related record.

My merge field is not displaying correctly

Check the merge field syntax. Merge fields must use the correct format, such as {{contact.email}}.

My company merge field is blank

Company fields only populate when the contact is associated with a company record.

I need a fallback value

Kyrios does not currently support fallback values for empty merge fields. Use Conditional Sending in the email builder as a workaround.

FAQ

What is the difference between custom fields and custom values?

Custom fields store unique data for individual records. Custom values store reusable information that can be used across multiple templates, workflows, websites, and funnels.

Are merge fields case-sensitive?

Yes. Merge fields are case-sensitive. For example, {{contact.name}} and {{Contact.Name}} are not the same.

What happens if a merge field has no data?

Kyrios replaces the merge field with a blank value.

Can I edit or delete standard fields?

No. Standard fields are built in and cannot be edited or deleted.

Can I use custom values in websites and funnels?

Yes. Custom values can be used to display consistent, reusable information across websites and funnels.

Can I organize custom values?

Yes. Custom values can be organized into folders.

Can I bulk create custom fields or custom values?

No. Custom fields and custom values must be created individually.

Can a trigger link start a workflow?

Yes. A trigger link can trigger workflow actions when a contact clicks the link.

Did this answer your question?