Home/HighLevel/Features/AI Employee/Set up custom values and variables in HighLevel Agent Studio

AI

Set up custom values and variables in HighLevel Agent Studio

In short

Custom Values and variables let an Agent Studio workflow pull real data such as contact details, business info, dates, or form inputs automatically. By inserting placeholders, a single agent can serve many locations or contacts without manual edits.

AreaAI Employee · Agent Studio
Used forRetail chain, Real estate agency, Event registration site
Setup steps13 steps in 1 task
Last updatedNovember 17, 2026

01Who this is for

  • Founders who run multiple locations and need a single agent template that adapts to each site’s settings.
  • Marketing teams that want to personalize messages with contact fields without rewriting copy for each campaign.

02Custom Values and variables, explained

Custom Values are reusable key value pairs stored in Settings > Custom Values. Once defined, they can be referenced in any text field inside an agent using the {{custom_values.key}} syntax. Variable placeholders pull data from five built in sources: Account, Custom Values, Right Now, Form Data, and Contact. When the agent runs, each placeholder is replaced with the current value from its source.

These placeholders work in AI prompts, text generation nodes, tool inputs, message cards, and conditional logic. If a source does not contain a value, the placeholder returns an empty string, preventing the agent from failing. Right Now variables automatically apply the subaccount’s timezone, and Form Data variables are only available when the agent is triggered by a form submission event.

03How businesses use Custom Values and variables

  • Retail chain. Define a support email as a Custom Value and reference {{custom_values.support_email}} in order confirmation messages. Updating the email in Settings right away changes it across all store agents.
  • Real estate agency. Insert {{contact.first_name}} and {{contact.email}} into lead follow up prompts so each prospect receives a personalized greeting without editing the workflow for each contact.
  • Event registration site. Use {{form.event_date}} inside confirmation texts, which only appears when the agent is started by a form submission, ensuring the correct event date is shown to each registrant.

04How to set up and use Custom Values and variables in HighLevel

Set up Custom Values and variables

  1. Navigate to Settings > Custom Values.
  2. Select Add Custom Value.
  3. Enter a Name and the corresponding Value.
  4. Click Create to store the new Custom Value.
  5. Go to AI Agents > Agent Studio and open an existing agent or create a new one.
  6. Click inside any prompt or message text box.
  7. Open the variable picker by clicking the dropdown arrow or by typing {{.
  8. Choose a category: Account, Custom Values, Right Now, Form Data, or Contact.
  9. Select the specific variable you want to insert.
  10. Click Save to store the changes.
  11. Select Test, run a sample conversation, and verify that each placeholder resolves correctly.
  12. If a placeholder appears blank, confirm that the required data exists in the contact record or location settings.
  13. When the test succeeds, promote the agent to Production.

05What it looks like in HighLevel

06Settings that matter

  • Custom Values. Stores reusable key value pairs that can be inserted into any agent text using the {{custom_values.key}} placeholder.

07Things to know before you rely on it

  • If a placeholder has no associated data, it returns an empty string instead of causing an error.
  • Form Data variables are only populated when the agent is started by a form submission event.
  • Variable names are case sensitive; use the exact key shown in the picker.
  • Right Now variables follow the timezone set for the subaccount.

08If something goes wrong

  • A variable shows up blank during testing.. Check that the required data exists in the contact record or in the location settings.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Custom Values and variables are a neat way to keep agents tidy and up to date.

Teams that never need dynamic content or personalization can skip it.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 17, 2026

Common questions

Common questions about Custom Values and variables.

What happens if a Custom Value is deleted?

The placeholder returns an empty string and the agent continues running without error.

Can I reference Opportunity or Task fields with variables?

No. Currently only Account, Custom Values, Right Now, Form Data, and Contact sources are supported.

What occurs when a variable has no value?

The system substitutes a blank value, preventing the agent from stopping.

Do Right Now variables respect the account’s timezone?

Yes. They use the timezone configured for the subaccount.

Can Form Data variables be used in any part of an agent?

They are only available when the agent is triggered by a form submission event.

Are variable placeholders case sensitive?

Yes. The key must match exactly as shown in the variable picker.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.