Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

How to create new records in the CRM, and edit existing records with new/updated data.

Use Case(s)

Oftentimes, Clubs will utilize Campaigns to reach out to Prospects based on their funnel stage, lead source, or interests.  Additionally, Clubs may utilize Campaigns to reach out to Members who have not been to the Club in awhile, as determined by a Member’s online reservation history.A CRM Record is a collection of data from related fields from within the same object. The most common example of a record is a single Contact. This contact record contains various fields, housing specific data pertaining to that contact.

However, CRM Records are not limited to just Contacts. Often, you may need to create Activities, Notes, Event Opportunities … the list goes on!


Content

Table of Contents
maxLevel4
minLevel2
excludeCRM - Creating/Editing Fields, Views & Layouts

 

Accessing the Tool 

...

Image Removed

Image Removed

Step 4 - Review

In this step you have the opportunity to review your input for all previous steps. If you notice any edits that need to be made, you can easily return back to any step in the process either by clicking on the button at the bottom of the screen labeled Last Step - Create Message or by clicking on the name of the step from the cookie trail at the top of the screen.

    • Properties: Displays the information entered as Properties for this Campaign. Remember that everything in this section is internal only, and will not be seen by Campaign recipients.
    • Targets: Displays the set of contacts that you are targeting with this Campaign. You can see the Object or Query that you targeted in the grid, or to view a list of all returned targets, you can click the blue button labelled Show Recipient Listing.
    • Create Message: Displays the From Address, Subject, and body content of the email that will be sent out via this Campaign. Also displays the selected Schedule and Send At time for the Campaign, at the bottom of the section.

Finally, at the bottom of the Review screen, there are four options:

    • Last Step - Create Message: This will bring you back to the previous step and enable you to make any changes to the email.
    • Send Test Message: Displays a small popup window that enables you to send this Campaign to a single recipient - as a test only - so that you can review the format of your email in a live email client.
      • IMPORTANT NOTE: It is highly recommended that you utilize this feature at least once before officially sending the Campaign.
    • Save Draft: Saves your current Campaign as a Draft and returns you to the list of active Campaigns.
    • Finish: This is your Send button. Once you click Finish, the system will queue your email messages to be sent according to the schedule you set earlier. If you chose Now as your desired time, then clicking the Finish button will queue your emails to be sent immediately.

Image Removed

Image Removed

Viewing Your Campaign History

To access a list of all the Campaigns that have been sent via your CRM, and to view the statistics for each Campaign, click on the Campaign History link in the sidebar, under the Communication section.

Image Removed

Campaign History Overview

The first screen you will see once you click on Campaign History in the sidebar is the Campaign History Overview. Here, you are able to view an overview of all Campaigns sent via your CRM, with some aggregated statistics for each.

The filters at the top of this page allow you to adjust which Campaigns display in the bottom part of the page. You can filter your results upon the following criteria: 

    • Campaign Name: This is the name entered in the Properties section for each Campaign.
    • Subject: This is the subject of the email that was sent.
    • Sent By: Enables you to choose from the list of all available outgoing addresses in your CRM.
    • Type: Choose between Email and Mail Merge.
    • Sent On or After & Sent On or Before: Enables you to view all Campaigns sent between the dates that you choose in these respective fields. Be sure to accurately set the necessary date range to return the specific Campaign(s) you wish to view statistics for.

Beneath these filters is a list of all the messages that have been sent via Campaigns in your CRM that meet the criteria as specified by the filters. See below for a brief description of each column in this report:

    • Campaign Name: This is the name you entered in the Properties section of your Campaign. Click on this name to view statistics for this individual Campaign, including a list of all messages that were sent as part of this Campaign (in the event that the Campaign was sent on a recurring basis).
    • Message Subject: This is the subject of the emails that were sent out in this Campaign. You can click on this name to view a more detailed overview of the statistics for this specific message.
    • Sent By: Displays the email address that this message was sent from.
    • Selected Recipients: Displays the number of email addresses that were targeted with the Campaign.
    • Recipients Sent To: Displays the number of email addresses that actually had the message sent to them. Typically, if this number is lower than the total of Selected Recipients, it is due to unsubscribes or duplicate email addresses.
    • Opened: Displays the number of messages that were opened by the recipients.
    • Open Rate: Displays the percentage of recipients that opened the email to those that received the message, but never opened it.
    • Link Clicks: Calculates the total number of clicks on hyperlinks included within the email message. You can view a breakdown of link clicks per hyperlink by clicking on the Message Subject.
    • Timestamp: Displays the time that the message was sent from the system.
    • Re-Send: Enables you to send this exact message again, to the same group of targets, or a subset of the original group of targets. Your sending options are:
      • Use Campaign Targets: Will send the new message to the exact same group of targets as the original Campaign was sent to.
      • Use Campaign Targets, Ignore Recipients Who Opened Original: Will send the new message to ONLY those contacts who received the original message, but did not open it.
      • Original Recipients Only: Will send the new message to those contacts that the original message was sent to. This is different from Use Campaign Targets because it excludes any contacts that were targeted, but did not have the message sent to them, either due to a missing email address from their CRM record, their email address already being present in the target list in a different CRM record (duplicate email addresses), or because they had previously unsubscribed from your CRM Campaigns.
      • Original Recipients Only, Ignore Recipients Who Open Original: Same as the previous option, excluding those who opened the original email.

The statistics on this initial screen serve as an overview of your sent Campaigns. If you need to “drill down” deeper into any given Campaign, or even a specific Message from within a Campaign, you can do so by clicking either the Campaign Name or Message Subject. 

Image Removed

Campaign Details

 

To access the details of a Campaign as a whole (especially for those with recurring messages), click on the Campaign Name from the Campaign History screen. Here, you will be able to review the properties of this Campaign, as well as view an overview of all the individual messages that have been sent as part of this Campaign.

The details in this section are very similar to those on the previous screen, but this view allows you to easily gauge the long-term effectiveness of recurring email Campaigns. You are also able to drill down into the message details of any message in the list by clicking on the Message Subject of that message.

Image Removed

Message Details

To access the details of a message sent through a Campaign, click on its Message Subject from either the main Campaign History screen, or from the Campaign Details screen. Here, you will be able to view the properties of the Campaign that this message was a part of, as well as review the body of the email itself.

Further down, you will see a list of all the links contained within this email, and how many clicks each link received. You are able to see a list of all the contacts that clicked on the link by clicking on the number in the Clicks column.

The last section on this screen displays a list of all the recipients of this message. You are able to filter the results to track down a specific email address, by typing that address into the box labelled Sent To and clicking the Filter button. You are also able to filter the results on the following three categories: 

    • Opened: When this box is checked, only recipients that opened the message will appear in the listing below.
    • Unsubscribed: When this box is checked, only recipients that clicked on the unsubscribe link within your message will appear in the listing below.
    • Bounced: When this box is checked, only recipients that had the message bounce back from their email address (meaning they were unable to actually receive the message) will appear in the listing below.

The statistics that are shown for each recipient are broken out as follows: 

    • Sent To: Displays the CRM record that this message was sent to. Click on this name to display the message history for this record.
    • Address: Displays the email address that corresponds with the CRM record that this message was sent to. Click on this address to generate a new email to this email address.
    • Sent At: Displays the timestamp at which this message was sent from Clubessential’s email servers to the recipient.
    • Opened: Displays the time that the recipient opened the message. If the recipient did not open the message, this field will remain blank.
    • Unsubscribed: Displays the time that the recipient unsubscribed from the message. If the recipient did not unsubscribe from this message, this field will remain blank.
    • Bounced: Displays the time that this message was marked as having bounced. If the message was delivered successfully, this field will remain blank.
    • Link Clicks: Displays the number of times that this recipient clicked on any link within the message.

Image Removed

Image Removed

 

FAQs

 

Q: How can I manually select which contacts to target with my Campaign?

A: Sending to an Object:

 

  • Send To: Choose Object
  • Object Type: Choose the Object to send to (most likely Contacts)
  • Records: Choose All Records to send this Campaign to ALL records within your CRM. Choose Selected Records to bring up an additional section for you to select individual contacts.
  • Select Records: This section appears when you select Selected Records in the option above. Search for contacts by name in the search bar, and click Filter to narrow down the list. Check the box next to each contact that you would like to send this  Campaign to.
  • Email Fields: Select the CRM email field(s) that you would like to target for each selected record you’ve chosen.
  • Return Email Targets: Click this button once you have filled out each of the options above, and your targets will be selected for this Campaign!

Q: Can I use multiple queries as targets for my Campaign?

A: You are only able to select one Query at a time as the target for a Campaign. If you want to send the same message to multiple queries, you have two options:

 

  • Contact your CRM support team to create a new query that targets everyone you need, and use this query as the target for your Campaign.
  • Copy your Campaign, and change the Target for the new one.

Best Practices

 

  1. Always be sure to send a Test of your message before finishing your Campaign. This allows you to be sure that the formatting of your email is correct when viewed from within an actual email client. Microsoft Outlook is particularly notorious for displaying certain elements of email messages differently than the rest of the internet, so if you have this installed on your computer, it can be beneficial to send yourself a test there to troubleshoot.
  2. If you are sending your Campaign to the results of a Query, run that query before sending, and go through the results to ensure that the contacts returned are exactly who you expect them to be. If you notice any discrepancies, don’t hesitate to contact your CRM Support Team!

 

Downloadable Guide

CRM Campaigns - Guide

 

...

From within To access your CRM, click on the Campaigns link in the sidebar, under the Communication section.

Image Removed

Starting a New Campaign

From the Campaigns screen, click on the blue button labeled Create New Campaign.

Image Removed

Step 1 - Properties

All the information on this screen is for internal use only - your selected recipients will not see anything that you enter on this page.

...

When finished populating information, click Next Step - Add Targets.

 Image Removed

Step 2 - Targets

In this step you will select who will receive the email from this Campaign. To begin, click the blue button labeled Add Targets.

In the Send To dropdown box, you will need to choose what type of target you will be sending to:

    • Object: This will allow you to send to all Contact records within your CRM at once (which you probably never want to do), or allow you to choose records to target one by one. This can be useful if the group you are targeting can not easily be selected in a query.
    • Query: This allows you to send an email to the results of a query saved in your system. This is useful for sending emails to groups of contacts in your system that are grouped together by shared criteria, such as Membership Level, Qualification or Age, to name a few.

To send to an Object, follow the below steps:

    • Send To: Choose Object
    • Object Type: Choose the Object to send to (most likely Contacts)
    • Records: Choose All Records to send this Campaign to ALL records within your CRM. Choose Selected Records to bring up an additional section for you to select individual contacts.
    • Select Records: This section appears when you select Selected Records in the option above. Search for contacts by name in the search bar, and click Filter to narrow down the list. Check the box next to each contact that you would like to send this Campaign to.
    • Email Fields: Select the CRM email field(s) that you would like to target for each selected record you’ve chosen.
    • Return Email Targets: Click this button once you have filled out each of the options above, and your targets will be selected for this Campaign.

Image Removed

Image Removed

To send to a Query, follow the below steps:

    • Send To: Choose Query
    • Query: Choose a query from the list that you would like to target with this Campaign.
      • You may only select one query per Campaign.
      • If you do not see the query that you need listed, it may need to first be created. Please contact your CRM support team for assistance (educational materials for CRM Query creation are coming soon).
    • Email Fields: Select the CRM email field(s) that you would like to target for each selected record you’ve chosen. Please note that, in order to function, at least one email field must be returned in the selected query chosen as a Campaign target.
    • Return Email Targets: Click this button once you have filled out each of the options above, and your targets will be selected for this Campaign.

Image Removed

Step 3 - Create Message

In Step 3, you will craft the actual email which will be sent to the selected targets of this Campaign.

...

sign in to your member website as an Administrator. Then, hover over the Admin toolbar in the top, left-hand corner of the page. The CRM link should appear in either the Communication or Content Management section, sometimes titled CRM & Data Warehouse.

 The information covered in this section is mostly found in the Admin Dashboard of the CRM. To access this, while on the main CRM Dashboard (above), hover over your name in the top, right-hand corner of the CRM, and click the Setup option.

 From here, you will see the CRM Admin Dashboard, which looks similar to the CRM Home Dashboard, but with a different sidebar on the left, and no Application Links at the top.

 Editing Fields/Views/Layouts

As an administrative CRM User, you have access to almost all of the editable settings within your CRM. This includes creating new fields, adjusting the fields visible in a given View/Layout, and editing the values within an existing picklist field, among many other permissions.

 Adding/Editing Fields

Your CRM should already include many different fields, containing a variety of different types of data. However, often you may need to begin storing a new piece of data that does not already have a corresponding field in the CRM, or you may need to edit the list of values available to choose from in a Picklist field. 

Adding a New Field

To begin, you’ll need to first decide what Object your new field will reside in - that is, what is it that this field will be helping to describe? The most commonly used Object in CRM is Contacts Object. All fields in the Contacts Object should be used to directly describe a person, whether they are a Member, Prospective Member, Guest, or other. In this example, the field we are adding is “Beverage Preference”, which will allow us to choose which beverage this Member prefers when they dine. This field would most accurately describe a Contact, so we will create this new field in the Contacts Object.

 To create your field, you’ll first need to access the Admin Dashboard. To do this, first start at your CRM home screen, then hover the mouse over your name in the top right corner, and click the Setup option.

 

To add your new field from here, you’ll first need to open your Contacts Object for editing. From the left-hand sidebar, click on Options to expand the list and display all of the Objects present in your CRM. Contacts should almost always be the first Object listed. Click Contacts to expand the list further, and then click Fields to view the list of existing Fields for the Contacts Object.

Before adding in your new field, scroll through this list to see if it already exists. If it does, then you can skip ahead to either Editing a Layout or Editing a View to add this field where needed. If it does not already exist, then navigate to the top of the list of fields, and click on the blue button titled + Add New Field.

Once you click on the + Add New Field button, you should see a list of blank field properties:

 

      1. Label: This is the field name, as it will display across the CRM. When choosing a name, be descriptive, but concise. Ex: Application Date
      2. Column Name: This is the database name of the field you are creating. This should automatically generate once you click out of the Label field. In most cases, it is best to leave this as the default value.
      3. Description: An optional field that allows you to enter a longer description of the field you are creating. This will only be seen in the full list of fields for the corresponding Object. Typically, if your Label is descriptive enough, this can be left blank.
      4. Data Type: Choose the type of data that will be accepted in this field. There are many options, but the most commonly used are:
        1. Checkbox: Sets this field as a checkbox, which can either be checked (true) or unchecked (false).
        2. Currency: Sets this field as a number, formatted for currency. Useful for tracking different revenue streams, and automatically appends the $ sign and decimal when entering data.
        3. Date: Sets this field as a date, with no time value. Brings up a datepicker when entering data.
        4. Date/Time: Sets this field as a date with the time appended. Brings up a datepicker with time selector when entering data.
        5. Email: Sets this field as a text box with forced formatting for email addresses. Fields of this data type can be used as targets for Campaigns, or can be used to directly send emails from a View/Layout.
        6. Number: Sets this field as a number, and allows you to configure the allowable size of number (in digits) and number of decimal places allowed.
        7. Picklist: Sets up a dropdown list of options to choose from, of which only one option can be selected.
        8. Picklist (Multi-Select): Sets up a list of checkboxes, representing options, from which multiple values can be selected.
        9. Text: A standard text box, with no formatting applied. Useful for displaying short pieces of basic information, such as names, addresses, phone numbers, etc. Allows you to set the maximum number of characters that can be entered, and whether or not all values in this field must be unique across the entire Object.
        10. Text Area: A larger text box, with no formatting applied. Allows you to set the maximum number of characters that can be entered.

For our example, we’ll choose the Picklist option, which will allow us to choose from a list of options (that will be populated now) when filling in this data on Member records later on. Once you select Picklist from the Data Type drop-down, the screen will reload and some new options will appear below.

 To begin, the list of drop-down option to choose from will be blank, so we will need to populate those options. To do this, click inside the text box next to the blue button titled Add Option and type the name of the option that you would like to add. Once complete, click the Add Option button, and your option will appear in the box above. Repeat this process as needed until all the necessary options have been added. You can reorder the list by clicking on an option, and then using the Up or Down Arrow buttons to the right of the options box to move that option up or down in the list. You can remove options by clicking on the option to remove, and clicking on the “X” icon just under the Up/Down Arrows.

 There are two more Field settings available before the Save button. Choose whether to sort the options in the order they appear in the listing you just created (default), or to sort all the options alphabetically, regardless of how they were entered.

 Finally, choose whether this field should be required. If the field is marked as required, any record that is created or edited in this Object will not save until a value is entered for this field. It is recommended to only use this for fields that would appear to all types of records within this Object (in our example, the Contacts Object). Therefore, making the Member Number field required would not be recommended, as all Prospects, Guests, Realtors, etc. do not have a Member Number, and you would not be able to save a new Prospect (or similar) record until a Member Number was entered. However, the Primary Email Field may be good to set as required, if you are certain that you will be able to fill this in for each contact that you enter.

 Once you have completed the steps above, click the blue button at the bottom of the page titled Save Properties, and your field will be created.

 A field does no good if it is not visible, so continue reading to learn how to add this new field into a View and Layout, so you can both view and edit the information in this field for your CRM records.

 Adding/Editing a CRM View

A View in the CRM is a screen that displays a high-level overview of a subset of records from within a single Object in the CRM. Views typically have filters in place that will display only records that meet certain criteria. For example, the “Our Members” View will display all records in the Contacts Object that have a status of “Member.” The fields displayed in a view are customizable to match the type of record displayed within. For example, the “Member Number” field makes sense to appear in the “Our Members” View, but not in the “Membership Prospects” view.

Adding a New View

To create your View, you’ll first need to access the Admin Dashboard . Similar to adding Fields, you’ll need to think about which Object this View will reside in. In this example, we’ll be adding the new View “Real Estate Prospects” to the Contacts Object.

 To add your new View from here, you’ll first need to open up your Contacts Object for editing. From the left-hand sidebar, click on Options to expand the list and display all of the Objects present in your CRM. Contacts should almost always be the first Object listed. Click on it to expand the list further, and then click on Views to be brought straight to the Views section of the Contacts Object setup screen.

 You should now see a list of all available Views within the Object you are editing. To edit an existing View, click on the gray Edit button immediately to the left of its name in the listing. To see a live representation of this View, click on the gray View button immediately to the left to its name in the listing. To add a new View, click on the large blue button titled + Add New View.

 You should now see the Edit View screen:

      1. Name: Enter a short, descriptive name for this View. Ex: “Real Estate Prospects”
      2. Description: Optionally, enter a longer description of this View. This would be seen only on the Views overview, and not from the View itself.
      3. Layout: Select which Layout will be related to this View. Whenever a user clicks to view a record from this View, this is the Layout that will display that record’s information. For example, a new View for “Members” should use the “Members” Layout so that, when a record is opened from within the new View, the full list of Member information is displayed.
      4. Object Default: Check this box to make this View the default for this Object. Any reference to this Object that does not point to a specific View will instead show the Object Default View.
      5. Object Display Name: Dictates how the Object will be referenced from within this View. For example, this changes the verbiage of the Add New Record button from within the View. If left blank, the default is set to the Object Name.
      6. Fields: Lists which Fields are visible within this View. By default the system fields RecordName, Created, and Updated are visible. The order that the fields appear in this list is the same as how they will appear in the View (the top-most field will appear furthest to the left in the View). The options for each row are:
        1. Edit: Allows you to change the value in the Display As and User Filterable columns for this row.
        2. Column Name: Displays the Column Name of the field that is set to display in the View in this position.
        3. Data Type: Displays the data type of the field that is set to display in the View in this position.
        4. Display As: Allows you to change the verbiage that displays for this field in the View. For example, you could change the wording of the Updated field to Time of Last Update.
        5. User Filterable: Enables this field to be added to an Advanced Filter in the View, for on-the-fly filtering.
        6. Positioning Arrow: Click and drag this arrow up or down to reorder the fields within the table.

At the bottom of the list of fields is a blue button titled Add New. Clicking this button will add a new row to the bottom of the existing list, and allow you to configure a new field in this View.

 

      1. Sorting: Allows you to configure the sorting options for records within this View. All sorting can be in either ascending order (lowest to highest) or descending (highest to lowest) order.
        1. Enable User Sorting: Enables users to change the sort order in this View manually by clicking on the column header. Checked by default.
        2. Multi Column Sorting: Enables users to sort this View by multiple columns.
        3. Default Sort: Configures the sort order that will be applied to the records within this View by default when it first loads. More details on this below.
        4. Default Sort Always Applied: When checked, the default sort order will always apply. Any user sorting (if enabled) will only take place after the default sort. In many cases, this prevents user sorting entirely, so it is recommended not to select this option unless you want to prevent user sorting.

Default Sort: Under the Default Sort option, click on the button titled Add Sort Field to configure the default sorting of this View.

From here, select which field you would like to sort by. The default sort order of any given field is descending (down arrow). Click on the field again to flip the order to ascending (up arrow). You can add additional sort fields to do more advanced sorting.
  1. Filtering: Configure which field(s) this View uses to filter out records, and therefore which records are displayed in the View.
    1. Quick Filter Field: Choose which field(s) will be used in the search field within this View. RecordName is always enabled by default, but you can enable more fields here as needed. For example, in order to search by both Contact Name and Email address, be sure to check the boxes for RecordName and Primary Email - then the desired search criteria will check both the RecordName and Primary Email fields for a match.
    2. Show Letter Picker: Determines whether the letter picker will display at the bottom of the screen in this View. Checked by default.
    3. Default Filter: Configures to default filter for this View, so you can tailor which records will be displayed. Click the blue button titled Edit Filter to open a popup window with the filter options:
At the top of the popup window is a table in which the field(s) to be used as filters are entered. Click on the blue Add New button to configure a field for this filter. The options for each line of the filter are as follows:
  1. Index: Used in the Filter Logic section below to target this line in the filter. This value is automatically generated.
  2. Column: Select which field to use in the filter.
  3. Operator: Choose how to compare the selected field to the value entered in the Value column.
  4. Value: Enter (or choose, for picklist fields) a value to compare the selected field against.

Once you have filled out all the fields in this line, click Save, and your new field comparison will be added to the table. You can repeat this as many times as necessary to build your filter.

Underneath this section is a text box to enter in logic commands to combine the fields entered in the table. This is only necessary if more than one field is selected in the table (if only one field was chosen to filter, then this section should be left blank).

In this section, use the operators “AND”, “OR”, “NOT”, and parenthesis to combine the field comparisons from the table above, using the Index value to refer to a specific line. See the below image for example:

 In this image, there are three lines of logic entered:

 

  • Status Equal “Membership Lead”: will be True if a record has a value of “Membership Lead” filled out in their Status field, otherwise will be false.
  • Status HasValue: will be True if a record has any value at all in the Status field, otherwise will be false.
  • Membership Opp Stats Equal Open: will be True if a record has a value of “Open” filled out in their Membership Opp Status field, otherwise will be false.


In this example, we’ve entered the following line of logic:

 

  • (A OR NOT B) AND C

In plain English, this states that:


  •  Records that have a Status that is either EQUAL to “Membership Lead” OR that have no value entered in the Status field, AND which have a Membership Opp Status EQUAL to “Open”.

Once you have set up your filter as needed, click on the blue button labelled “Apply Filter” and your filter will be applied to the View.

 Options:

Use this section to configure some final miscellaneous options for this View. The Options available are:

 

      • Show Add New Record: When checked, a button will be present in the View to allow users to add new records. Unchecking the box will hide this button from this View only.

      • Show Edit Record: When checked, a link will be present next to each record allowing users to edit the selected Record. Unchecking the box will hide this link from all records in this View only.

      • Show Delete Record: When checked, a link will be present next to each record allowing users to delete the selected Record. Unchecking the box will hide this link from all records in this View only.

      • Allow Export: When checked, a button will be present in the View to allow users to export the records within this View. Unchecking the box will hide this button from this View only.

      • Allow Messaging: When checked, users will be able to send messages to records containing email addresses either by hovering the mouse over an email address visible in the View, or by selecting a record and clicking on the Messaging button. Unchecking this box will hide the button from this View only, and also prevent the Message option from appearing under email addresses in this View only.

      • Enable Paging: When checked, this View will be split into pages of 20 records each, which can be scrolled through to view all records. Unchecking this box will force all records returned in this View to load on the same page, and remove the paging for this View only.


Security:

Generally, security options for Views are not configured from the View itself, but rather in the Role Groups section, so we will not cover this section. By default, all options are set to Inherit From Parent Object.

 Please contact your CRM Support Team if you need to lock down a View from certain users, as we are happy to cover this with you on a one-on-one basis.

 Adding/Editing a CRM Layout

To create your Layout, you’ll first need to access the Admin Dashboard. Similar to adding Fields and Views, you’ll need to think about which Object this Layout will reside in. In this example, we’ll be adding the new Layout Real Estate Prospect Entry to the Contacts Object.

To add in your new Layout from here, you’ll first need to open your Contacts Object for editing. From the left-hand sidebar, click on Options to expand the list and display all of the Objects present in your CRM. Contacts should almost always be the first Object listed. Click on it to expand the list further, and then click on Layouts to be brought straight to the Layouts section of the Contacts Object setup screen.

 You should now see a list of all available Layouts within the Object you are editing. To edit an existing Layout, click on the gray Edit button immediately to the left of its name in the listing. To add a new Layout, click on the large blue button titled + Add New Layout.

 You should now see the Edit Layout Screen:

 When first creating a new Layout, you will only see sections 1-4. Section 5 will appear once you click the Save Properties button.

 Properties: In this section, enter the basic identifying information for this Layout.

      • Name: Enter a name for this Layout. You will use this to reference your Layout in a View, or for future editing.

      • Description: Optionally, enter a description of this layout. This is only visible when editing the Layout, not when viewing data within the Layout, so most users will not see anything written here.

      • Object Default: Check this box to set this Layout as the default for this Object. Any links to records of this Object will open the default Layout unless the link specifically targets a different Layout.


Security: Generally, security options for Layouts are not configured from the Layout itself, but rather in the Role Groups section. By default, all options are set to “Inherit From Parent Object”.

Please contact your CRM Support Team if you need to lock down a Layout from certain users, as we are happy to cover this with you on a one-on-one basis.

 Header Text: This section is used by your CRM Support Team to add in client-side scripting or style code to this Layout. Generally, it is advised not to enter anything in this section yourself unless you are proficient in writing Javascript and/or CSS code.

Information: Displays system information about this Layout, and includes action buttons for the Layout.

      • Created: The time this Layout was created, and the user that created it.
      • Modified: The time this Layout was last modified, and the user that made the changes.
      • Save Properties: Saves the Properties of this Layout (anything entered in sections 1 -3 above).
      • Save As New Layout: Creates a brand new Layout in this Object, and gives it the exact same Properties and Structure as this Layout. Useful for creating two similar Layouts with only minor differences.
      • Archive This Layout: Will remove this Layout from the list of Layouts in this Object, and will prevent it from being displayed to Users.


Layout Structure: This section allows you to configure the structure of the Layout. Here you can determine which fields are shown in this Layout, and in which order.

At the top of this section is a list of actionable items (Available Fields and + Add Section), which can be dragged below to place them in the Layout body.

 Beneath this is a canvas, on which you place Sections and Fields to display in the body of the Layout. This canvas is made up of Sections, and each Section is made up of Fields. When viewing a Layout from the user facing side, Sections keep fields organized within the Layout by providing a header/title, and each Section is also collapsible to enable the user to hide certain fields that they aren’t using at the current time. Typically, it is a good practice to have as many Sections as possible in your Layout to help group like fields together, and allow for a logical and visually pleasing display of data.

 Utilizing these two sections, you should now be able to begin formatting this Layout by clicking any item in the top section, and dragging it to the desired location in the canvas below.

 First, and most importantly, you’ll need to add in at least one Section, in which you’ll be able to place and order fields. Fields cannot exist in a Layout outside of a Section, so it is necessary to add in at least one Section before adding any Fields.

 To add a new Section, find the tab at the top of the Layout Structure section titled + Add Section. Click and hold on this, and drag it down to the canvas section, then release it where you would like it to be placed. You can reorder existing Sections in your Layout by clicking on the Section heading and dragging it up or down in the Layout to its desired location.
 

By default, your new Section will not have a title, and it will contain only one column for Fields. To edit the settings of this Section, click on its title, and a popup will appear in which you can edit the Section settings. 

In the Section Properties window, you can edit the following information:

      • Title: Give a title to this Section, which will be visible to users when viewing this Layout.

      • Column Count: Choose how many columns of fields should be available in this Section. The minimum number of columns allowed is 1, and the maximum is 4. Fields will stretch to fill the entire screen regardless of the number of columns. Therefore, fields will appear larger in a Section with fewer columns, and will appear smaller in a Section with more columns.

      • Collapsed on Display View Load: If this box is checked, then this Section will default to collapsed when the Layout is first loaded. Users would have to click on the Section title to expand it and view the Fields within. If this box is unchecked, then this Section will default to display all Fields within, unless the User clicks on the Section title to collapse it.


Once you’ve configured the Section as desired, click on the Save Properties button and this window will disappear. Then the Section will update in the Layout Structure beneath.

 With a new Section in place, now you can place some Fields. Adding Fields works very similarly to adding Sections - simply find the Field you would like to add in the list of available Fields in the top section, then click and drag it down to the canvas where you would like to place it. You can also reorder existing Fields in the canvas by clicking and dragging them around to their desired location.

 Each field within a Layout has some basic properties that can be edited. To access these properties, hover over the field you need to access, and click on the small gear icon that appears over the bottom-right corner of the field.

 For most fields, there are only a few properties to edit:

      • Read Only: Mark this field as read only, so that users can view the content within it, but never edit it.

      • Required: Mark this field as required to be filled out before saving the record in this Layout. Choosing this option will only affect this field in this specific Layout.

      • Hide Label: When this box is checked, only the data contained within this field will be displayed - not the name of the field itself.


Finally, once all the Sections and Fields have been added to the canvas as needed for this Layout, click on the Save Structure button, which is located at the bottom of the list of available Fields.

Accessing Data From Outside Objects in a Layout

While using your CRM, you may have noticed cases in which data from one Object is displayed inside a Layout of a different Object. The Activities section within a Prospect Layout is a great example of this, as is the Notes section.

 These sections within the Prospect Layout are what are called Parent-Child Relationship fields. They allow data from one Object, in this case either the Activities or Notes Objects, to be displayed within a different Object, in this case the Contacts Object. In order to display this kind of information in a Layout, the associated Parent-Child Relationship field should be added to the Layout.

 Before editing the Layout, you should first determine which Parent-Child fields are available in your Object. Open up your Object for editing, and view the list of available Fields. You will be able to tell if a field is a Parent-Child field based on the Data Type of the field. Instead of showing a standard data type, a Parent-Child field will instead show the name of the Object that it is relating to.

 In the above example, the field Activity History has a data type of Activities signifying that it is a Parent-Child field, relating to the Activities Object. 

 Once you’ve identified a Parent-Child field, open up the Layout to edit, and scroll down to the Layout Structure canvas. To begin, add a new Section to house this field - generally you will want to have each Parent-Child relationship field to live in a section alone, as the field will display as a full section in the Layout. Typically, it is best to leave this section set to only one column as well, for the same reason.

 Next, locate the Field that you identified earlier from the list of available fields, and drag it down to this new Section. Instead of appearing as most of the other fields, this field will instead say “Record Name Object View”.

 Once the field has been added to the Layout, click the Save Structure button, and it should be ready to use. However, there are a few more properties that can be edited for this type of field, which can improve the user experience when viewing this Layout. To access the field Properties, hover over the field in the canvas, and click on the small gear icon that appears over the bottom-right corner of the field. This will bring up a popup window, pictured below:

 Here you’ll see the same list of field properties that exists for all fields, plus two new options:

        • Display Type: Select from the list which View from the Child Object (in this case, Activities) to use to display the content within this Layout. The fields that will be shown in your Layout are determined by the View selected in this option.
        • Layout: Select from the list which Layout from the Child Object (in this case, Activities) to display when a record from within this View is clicked.


If none of the options available in these lists are what you need, you’ll need to open up the Child Object and edit/create the Views/Layouts as needed.

 




 


 



 


 





FAQs

 

Q: Why can't I access the Object settings? I'm receiving an error 'Invalid Permissions to View This Page"?

A: Only Object Administrators have access to edit settings within an Object. If you are receiving this message, your account may not be set as an Object Administrator. Please note that CRM pricing is based on a per admin user basis, so adding additional Object Administrator accounts may incur additional fees. Contact your Account Manager to discuss this further.

 

Best Practices


  1. Adding/Editing Fields: Be as descriptive as possible with field titles to make data entry easier in the future. Typically, if a piece of data can be described using multiple fields instead of just one, it should be, to allow for more granular reporting. For example, instead of one address field, we have 5 - Street Address 1, Street Address 2, City, State, Zip Code.
  2. Adding/Editing Views: Keep the filters in Views simple - leave the more advanced filtering options for queries/reports. Try to design your Views to display large chunks of similar records, separated out by basic identifying features, such as Status, or Contact Type, etc.
  3. Adding/Editing Layouts: Generally, it is easier for users to use a Layout that has more Sections, as opposed to those that have fewer Sections. Use Sections liberally to group like fields together. For example, have a “Prospect Information” Section containing basic identifying and demographic information about a Contact, a Section for Addresses, one for Opportunity information, and another for Spouse/Family information.

 

Downloadable Guide

 

Creating Editing CRM Fields Views and Layouts

 

 

 

A View in the CRM is a screen that displays a high-level overview of a subset of records from within a single Object in the CRM. Views typically have filters in place that will display only records that meet certain criteria. For example, the “Our Members” View will display all records in the Contacts Object that have a status of “Member.” The fields displayed in a view are customizable to match the type of record displayed within. For example, the “Member Number” field makes sense to appear in the “Our Members” View, but not in the “Membership Prospects” view.