home

MinistryPlatform

RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

MinistryPlatform and PocketPlatform guides, answers, and development resources.

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

Record Insights

Text & Tokens

Explore what you can do with text and tokens insights to enhance record visibility and interactivity, to create impactful member experiences.

Ready to choose your own adventure? The text & token insights lets you do that! Brush off those HTML and SQL skills and create some helpful record insights to help your staff do ministry better.

  • Text & token record insights pull essential information and put it front and center. Think of these as your new and improved contact cards.
    • Contacts Page: Participant information
    • Participants Page: Contact information
    • Care Cases Page: Contact information
    • Care Cases Page: Participant information
    • Donors Page: Contact information
    • Donors Page: Participant information
    • Donations Page: Contact information
    • Donation Distributions: Contact information
    • Donation Distributions: Donation information
  • The text & tokens record insight is based on a mixture of HTML and tokens.
    Tip: Work in source code mode.
  • Tap the email address in one of the pre-loaded record insights to open your email app.
  • Use FontAwesome icons to make your record insight stand out visually.
  • Use the Advanced Search tool to create the tokens that render for each record.
Note: If you use the Advanced Search Tool to get the information for the tokens, it will look like this: primary_contact_table.[email_address]. For the purposes of record insights, move the left square bracket at the very start of the ID, so it looks like this: [primary_contact_table.email_address]. It may look weird the first time you do it. Just make sure the entire ID is in square brackets and that there are only two square brackets (one at the beginning and one at the end). And, you have a 128 character limit between those brackets.

Add Text & Tokens Record Insights

MinistryPlatform has a bunch of useful record insights by default. But if you want to add your own, you can do that if you have access to the System Setup section.

  1. In the navigation menu, click System Setup > Insights.
  2. Click New to create a new record insight. Or find one you like, and click Copy.
  3. Add or edit the necessary information:
    1. Title: A clear, concise title for your record insight.
      Note: The title will not display on the text & tokens record insight.
    2. Page: The page where the record insight will display.
    3. Sub Page View: Leave this blank.
    4. Template: The template for this insight.
      • Click the </> button to switch the Template field to source mode. Maximize the field for an easier experience.
      • Use HTML and tokens to create the record insight you want to see.
      • If you used the Advanced Search Tool to get your tokens, move that left bracket to the start of the clause.
      • The token value must be either the Table Field Name or Table Field Path.
    5. View Order: The order this insight will display in, from left to right.
    6. Active: Whether the insight will display on the page. No longer relevant, set this to No.
  4. Click Save.

Text & Tokens Examples

With a little HTML and knowledge of your database, you can add links to other pages in your insight. Here are some examples to get you started, but don't be afraid to get creative!

Link a Button or Text

You can add a button using HTML and use an href to link it to another page in your database.

You can use an href to link text to another page in your database.

Here's what those examples look like on the Contact record:

Contact Card for Group Primary Contact

This HTML template renders a contact card for the primary contact of a group.

<h3 style="text-align: center;">Primary Contact Card</h3> <div style="text-align: left; padding-left: 15px;"> <b> Attends:</b>[Primary_Contact_Table_Household_ID_Table_Congregation_ID_Table.Congregation_Name]</div> <div style="text-align: left; text-transform: lowercase; padding-left: 15px;"> <br><i class="fas fa-envelope-open-text" style="color: #4fb2cc;"></i> [Primary_Contact_Table.Email_Address] <br><i class="fas fa-mobile-alt" style="color: #4fb2cc;"></i> [Primary_Contact_Table.Mobile_Phone] <br><i class="fas fa-sms" style="color: #4fb2cc;"></i> [(SELECT CASE WHEN Primary_Contact_Table.Do_Not_Text = 0 THEN 'Allows Texts' ELSE 'Do Not Text' END)] <br><i class="fas fa-birthday-cake" style="color: #4fb2cc;"></i> [Primary_Contact_Table.Date_of_Birth]</div>

Contact Card with Clickable Phone Number

This HTML template renders a household contact card with a phone number that you can click to call.

<div style="text-align: center;"><b>Household Information</b></a></div> <div style="text-align: center;">The [Household_ID_Table.Household_Name] Family</div> <b><div><b><br></b></div>Home Phone</b>: <a href="tel:[Household_ID_Table.Home_Phone]">[Household_ID_Table.Home_Phone]</a><div> <div><br></div> <b>Address</b>: <br>[Household_ID_Table_Address_ID_Table.Address_Line_1] <br>[Household_ID_Table_Address_ID_Table.City],&nbsp;[Household_ID_Table_Address_ID_Table.[State/Region]]&nbsp;[Household_ID_Table_Address_ID_Table.Postal_Code]</div>

Address Fields

Use these fields in record insights to render the household address.

[Household_ID_Table_Address_ID_Table.Address_Line_1] [Household_ID_Table_Address_ID_Table.City] [Household_ID_Table_Address_ID_Table.[State/Region]] [Household_ID_Table_Address_ID_Table.Postal_Code]
Note: The second closing bracket on the city/state code is not a mistake.
thumb_upYes thumb_downNo

portal
MinistryPlatform

Last updated: March 25, 2025

Related Articles: