--- title: "Use custom fields for marketing" slug: "use-custom-fields-for-marketing" updated: 2026-10-16T00:58:52Z published: 2026-10-16T00:58:52Z canonical: "help.servicetitan.com/use-custom-fields-for-marketing" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # Use custom fields for marketing # ## Overview Use your custom fields to personalize email content with customer-specific data and target precise audiences when building segments. By leveraging the unique data you already collect, you can ensure your marketing campaigns are highly relevant to each recipient's service history and needs. --- ### #### Make sure you’re viewing the correct Marketing Pro content This article is for Marketing Pro v2. If you are using Marketing Pro, see [Use custom fields](/v1/docs/use-custom-fields) for content specific to your experience. You can check your version following these steps: 1. Go to the navigation bar and click **Marketing** ![A speaker icon representing Marketing in ServiceTitan.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-marketing.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D). 2. If the side menu under Analytics includes One-Time Campaigns and Automated Campaigns, you're using [Marketing Pro v2](/v1/docs/marketing-pro-v2). If these options aren't visible, you're using [Marketing Pro](/v1/docs/marketing-pro). ![Analytics section highlighted in the Marketing side menu.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/screenshot-marketing-analytics.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D) #### Who uses this feature - Administrators, marketing managers, and other marketers on your team - Primarily benefits Commercial Service and Replacement business types and Residential Service and Replacement business types - Applies to all trades #### Feature configuration - To get started with Marketing Pro v2, request a demo on our [Pro Products page](https://www.servicetitan.com/features/pro), or reach out to your Customer Success Manager (CSM) or Pro Account Manager (PAM). - Account configuration is required to use this feature. Please contact [Technical Support](http://go.servicetitan.com/ask) for details. ### ## Things to know - Custom fields must be enabled for marketing use before they appear in the email editor or segment builder. For more, see Configure custom fields for marketing. - Custom field merge tags and segment filters are organized by entity type — for example, **Calls** and **Jobs**. Only fields enabled in your Fields Settings appear in the list. - If a merge tag resolves to an empty value for a given contact — for example, because the custom field was not filled in on their record — that tag will appear blank in the email that contact receives. ## Best practices - Before inserting a custom field merge tag into an email template, check that the field has complete data for the audience you plan to send to. Incomplete data leads to blank spots in personalized content. - When building a segment that uses a custom field filter, preview the resulting segment size before adding it to a campaign. A very narrow filter may produce a segment too small to be effective. - Use custom field merge tags alongside standard merge tags — such as customer name or company name — to make emails feel specifically relevant to each recipient's service history or situation. ## Use cases - A marketing manager wants to follow up with customers who answered a specific intake question. They use the custom *How did you hear about us?* Job field as a segment filter to build a targeted audience for a referral campaign. - An administrator wants to personalize an email with the type of equipment serviced on a customer's last visit. They insert the *Equipment Type* custom field as a merge tag in the email body so each recipient sees details specific to their job. - A marketer is running a reactivation campaign. They use a custom *Last Service Category* field both as a segment filter — to target customers whose last job matched a specific service type — and as a merge tag — to reference that service type in the email subject line. ## Add a custom field merge tag to an email template After a custom field is enabled as a merge tag in Settings, it becomes available in the merge tag menu in the email template editor. 1. In the navigation bar, go to **Marketing ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/use-custom-fields-for-marketing-image-5myc8k9a.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D)**. 2. In the side menu, click **Email Templates**. 3. Open an existing email template, or click **Create New**. 4. In the email editor, place your cursor where you want to insert the custom field value and click **Add Merge Tag**. ![Email template configuration showing subject line, preview text, and content editing options.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/use-custom-fields-for-marketing-image-wytguuvm.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D) 5. Select the field’s source in the **Select Field Location** dropdown. For example, **Customer Record** or **Job Record**. 6. Select the custom field you want to add as a merge tag in the **Select Merge Tag** dropdown. > **Note:** If a custom field merge tag resolves to an empty value for a given contact, that tag will appear blank in their email. Review data completeness for your target audience before sending. ![Instructions for adding a merge tag in a customer record interface.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/use-custom-fields-for-marketing-image-0lj5wh3g.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D) 7. Click **Add**. 8. When you are finished editing, click **Save**. ## Filter a segment by a customer field After a custom field is enabled as a segment filter in Settings, it becomes available as a filter option in the segment builder. > **Note:** You can only use custom fields as filters for retention segments. 1. In the navigation bar, go to **Marketing ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/use-custom-fields-for-marketing-image-erexl5y7.png?sv=2026-02-06&spr=https&st=2026-11-09T11%3A42%3A02Z&se=2026-11-09T12%3A42%3A02Z&sr=c&sp=r&sig=JbdQpvKkJnKdCJ9biZ2rrU3w7xuPR2UsA4N5iytvg3w%3D)**. 2. In the side menu, click **Retention Segments**. 3. Open an existing segment, or click **Create Segment**. 4. In the segment builder, edit an existing filter or add a new one. 5. In the filter list, find your custom field under its entity category — for example, **Customer** or **Location** — and select it. 6. Set the filter criteria for the field. For example, select a specific value or define a range. 7. Review the resulting segment size to confirm the filter is returning the expected audience. 8. When finished, click **Save**. ## Want to learn more? - See [Configure custom fields for marketing](/v1/docs/configure-custom-fields) - See [Create Marketing Pro Segments](/v1/docs/create-marketing-pro-segments) - See [Create email templates](/v1/docs/create-email-templates-2) ServiceTitan's integrated marketing automation platform for email, SMS, direct mail, and digital ad campaigns. **What it does:** Drives new customer acquisition and repeat revenue by automating targeted campaigns across multiple channels — all tied to actual job revenue. **Also called:** ST Marketing, Marketing automation **Tags:** Marketing Pro [See the full glossary →](https://help.servicetitan.com/docs/glossary-overview) The top-level account in ServiceTitan representing a property owner or account holder, containing all locations, jobs, and history. **What it does:** Serves as the single source of truth for all customer interactions, history, and financial data. **Also called:** Customer account, Client record **Tags:** Core [See the full glossary →](https://help.servicetitan.com/docs/glossary-overview)