Placeholders
Placeholders let you add information to your letters and documents automatically. Instead of typing each owner's name, address, or offer price by hand, you add a placeholder to your template and Pebble fills it in for each property and contact when the mailer or document is generated.
For example, a letter that says:
Dear {{contact_name}}, I'd like to make an offer on your property, APN {{property_apn}}.
becomes, for each owner on your list:
Dear Mary Smith, I'd like to make an offer on your property, APN 123-456-789.
In this article:
What is a placeholder?
A placeholder is a tag, written between double curly braces like {{contact_name}} or {{property_apn}} , that stands in for a piece of information. When Pebble generates a mailer or a document, it replaces each placeholder with the real value from your records.
This is what lets you write one template and send it to hundreds or thousands of owners, each with their own name, address, and property details.

Attention: If a record has no value for a placeholder, that part of the document is left blank. For example, if a contact has no name, “Dear {{contact_name}},” becomes “Dear ,”. Check the preview before you send.
Where you can use placeholders
You can use placeholders in:
- Mailing templates for letters, postcards, and neighbor letters. See Templates.
- Documents such as offers and contracts. See Generating and Mailing Documents.
- Email and text templates, including the ones you use in Auto Follow-Up Plans.
Note: Placeholders only work in templates. If you write an email or text from scratch in your inbox, you can't add placeholders. To use them, create the email or text as a template on the Templates page, then choose that template when you write in your inbox.
Adding a placeholder to a template
- Click Templates at the bottom of the left sidebar.
- Open your template and click the place in the text where you want the information to appear.
- In the Templates menu, click Add Placeholder.
- Choose the type of placeholder (for example Contact, Property, or Campaign) and then the field you want (for example Price). Placeholders will be highlighted in blue.
- Scroll up and click Save Changes.

Once your template is saved, you can use it in a mailer, a document, or your inbox. See Templates.
Types of placeholders
Property placeholders
Property placeholders insert information about the property, such as its APN or acreage. Here are some examples:
{{property_apn}}: the property's APN{{property_acreage}}: the acreage{{property_address}}: there's one for each field of the property address-
{{county_name}}and{{county_state}}: for the county and state the property is located at
Every custom property field you create also gets its own placeholder, so you can use the information you collect during due diligence in your documents later in the process. See Adding Custom Property Fields.

Contact placeholders
Contact placeholders insert information about a buyer or seller, such as:
{{contact_name}}{{contact_phone}}{{contact_address}}{{contact_city}}{{contact_state}}{{contact_zip}}- And other contact-related fields
The same contact placeholder pulls different information depending on whether you're creating an acquisition document (buying property) or a disposition document (selling property):
For Acquisition Documents (Contract to Buy):
{{contact_name}}pulls the property owner/seller information.- Your company is listed as the buyer.
For Disposition Documents (Contract to Sell):
{{contact_name}}pulls the buyer information.- Your company is listed as the seller.
Example: When creating a Warranty Deed to sell a property to a buyer:
- Grantor (Seller): Your Company Name
- Grantee (Buyer):
{{contact_name}},{{contact_address}},{{contact_city}},{{contact_state}} {{contact_zip}}
If you need more than one buyer or seller on the same document, see Adding Multiple Contacts to a Document.
Campaign placeholders
Campaign placeholders insert information from the campaign, such as the offer price.
- Price: the offer price. If you imported a secondary price, it also shows the range (for example, $10,000 – $12,000). See Sending Ranged Offers.
- Price Words: the offer price, but spelled out in words.
- Mailer code: See Mailer Codes.
Owners with multiple properties
When one owner has several properties in the same campaign, Pebble groups them and sends that owner one letter with the information for every property.
You don't need to repeat a placeholder or create a separate one for each property. A single property placeholder, like {{property_apn}} , pulls all of the owner's values automatically. For example, if an owner has three properties, a letter with this template line:
Your properties: {{property_apn}}
lists all three APNs in that one letter.

This works the same way as ranged offers: you add one placeholder and Pebble adds up or lists the values for you. See Sending Ranged Offers.
How Pebble decides who gets the same letter:
- When you import a list, Pebble uses two unique values: Owner Full Name and APN. A different Owner Full Name creates a new contact, and a different APN creates a new property.
- Letters follow the rows of your list. If "Mary & Joseph" are in one row, that is one contact and one letter. If Mary and Joseph are in separate rows, they are two contacts and two letters.
See Importing Your Properties for how to import your list.
Previewing your placeholders before you send
Before you send a campaign, check that your placeholders are filling in correctly.
- In your campaign, click Start Mailing.
- On the activation screen, look at the preview of the mailer. Check that each placeholder shows real information and not the tag itself, for example
{{contact_name}}. - Tick the confirmation checkbox and click Activate Now when everything looks right.
For more on the activation screen, see Activating a Campaign.
Common questions
- A placeholder shows up as text, like {{contact_name}}, in my mailer. Check that the placeholder was added with Add Placeholder and not typed by hand, and that it is spelled exactly as it appears in the menu.
- Can I show a paragraph only when a certain condition is true? No. Conditional sections are not supported in templates at this time.
- Can I add a placeholder for information that isn't in my records? Yes, if the information is a custom property field. Create the custom field first, and Pebble gives it a placeholder automatically. See Adding Custom Property Fields.
- A placeholder is blank in the preview. That means that the record doesn’t have a value for that field. For example, a blank {{contact_name}} means the contact has no name. Add the missing information to the contact, property, or campaign, then check the preview again.
If many records are blank at once, a column may not have been mapped when you imported your list. See Importing Your Properties.
- Can I use placeholders when I write an email or text in my inbox? Only if you use a template. You can't add placeholders when you write from scratch. See Where you can use placeholders.