Contact records can be saved as a draft by clicking the ‘Save as draft’ button at the top of a contact record. This feature is useful if you need to come back and finish documenting the details of a contact record later, for any number of reasons. The following facts about draft contact records are important to consider:
- the ‘Save as draft’ button can be set to appear or be hidden in all contact record forms
- when a contact record is in draft, the data won’t be included in any reports
- contact records will remain in draft until the ‘Submit’ button is clicked
- by default, Admin and Supervisor level users can see, and edit all contact records in draft; there is an Advanced Security Setting to grant lower level users permission to edit other peoples’ draft contact records
It is best practice in iCarol to review contact records in draft on a regular basis to ensure users are completing documentation, and submitting the contact records in a timely manner so the data from the contact records are included in reports in Statistics and Data Exports.
To view and submit Contact Record Drafts, complete the following steps:
- From the main Contacts page, select ‘Drafts’ from the contacts view list on the left side of the page
- Depending on the user’s security settings, users will see only their own contact records in draft, or all users’ contacts records in draft
- Select the contact record you want to finish documenting, and click the ‘Edit’ button
- Finish documenting the contact record, and click the ‘Submit’ button
Geographic/Location Lookup and Data Entry
In Report V5, a new intuitive location look-up tool makes it easier to document your help seekers location. When using this tool, when you start typing a location, an auto-suggest list will appear with locations, based on a combination of your organizations' physical location and the text you’ve entered.
Complete the following steps to search for, and enter a location using the auto-suggest tool:
- Under the section Contact Information or Third Party Information, click in the text box ‘Enter location of the Caller'
- Start typing the location, such as zip (or postal) code, city, county, state (or province); as you type more characters, the suggestions will narrow
- From the auto-suggested drop-down list, select the location you are searching for
- To enter an ‘unknown’ location, type ‘00000’ or ‘unknown’ and select the related location from the drop-down list
- Notice the fields below the search box populate with the location data you selected
- If needed, click 'Clear' to remove the data you selected, or enter a new location using the search bar again
Complete the following steps to find a zip or postal codes associated with a location:
- Under the section Contact Information or Third Party Information, click in the text box ‘Enter location of the Caller'
- If you don’t know the exact zip/postal code, begin typing the most specific location you know, and continue entering a more specific location. For example, start by typing a city, then keep typing the name of the associated county or state.
- After your location is specific enough, notice the auto-suggested drop-down list has narrowed down to include locations with zip codes for you to choose from
- From the auto-suggested drop-down list, select a location with a zip code
By default, this is the location look-up tool enabled in all V5 contact reports. If you wish to enable or disable this tool, complete the following steps:
- As a user with appropriate security settings, from the main Contacts page, click the ‘Manage Contact Form Versions’ button
- Find the contact report form you wish to enable/disable this setting for, and click the link to ‘Edit this form’
- At the top of the page click the link to edit the ‘Overall settings for this call report form’
- Under the Places section, select, or deselect the checkbox next to the setting ‘Call Report uses Traditional Drop-Down style location control’; if the checkbox is deselected, the auto-suggest location lookup tool is used
- Click the ‘Save settings’ button at the bottom of the page when you’re done adjusting your settings
Note, if the zip codes provided in the auto-suggested drop-down list are not sufficient for your organization’s needs, then consider enabling the external zip code lookup. More information on this tool is below.
In Report V5, you have the option to enable the traditional location look-up tool that uses drop-down lists, as opposed to the auto-suggested lists. In Report V4, the drop-down list location lookup tools are the only option available.
When using this tool, depending on the fields enabled in your contact form, the following occurs:
- location fields appear as drop-down lists: Country, State/Province, County, and City
- when you select a location from a drop-down list, the other location drop-down lists automatically update to match your selection
- when you select a city or county from the drop-down list, a link appears for ‘All zip codes in this city/county’
- the Zip/Postal Code field appears as a searchable textbox
To find a zip code associated with a specific county or city, complete the following steps:
- Under the section Contact Information or Third Party Information, in the ‘Zip Code’ text box enter the help seeker’s zip or postal code
- Click the ‘Lookup’ button to the right of the zip code text box
- The related location fields are updated to match the zip or postal code you entered
- If more than one location is associated to the zip or postal code, a dialog box opens with a list of options to choose from
- Click one of the options displayed to select it
- The related location fields are updated to match the zip or postal code you selected
To find a county or city associated with a specific zip code, complete the following steps:
- Under the section Contact Information or Third Party Information, select the help seeker’s Country and State, then select their City or County
- Click the link that appears to see ‘All zip codes in this city/county’; select the appropriate zip/postal code from the list that appears, and it’s transferred into your contact record
If you wish to enable or disable this tool, complete the following steps:
- As a user with appropriate security settings, from the main Contacts page, click the ‘Manage Contact Forms Versions’ button
- Find the contact form you wish to enable/disable this setting for, and click the link to ‘Edit this form’
- At the top of the page click the link to edit the ‘Overall settings for this call report form’
- Under the Places section, select, or deselect the checkbox next to the setting ‘Call Report uses Traditional Drop-Down style location control’; if the checkbox is deselected, the auto-suggest location lookup tool is used
- Click the ‘Save settings’ button at the bottom of the page when you’re done adjusting your settings
Look-up location based on Phone Number or Zip/Postal Code
- When you enter a phone number or Zip/Postal Code inside a contact record, you can lookup the location of that phone number or Zip/Postal Code.
- The look up feature will retrieve City, County (in North America), State/Province based on the phone number or zip/postal code entered.
- This is a feature that may or may not be turned on for your agency, please check with your Admin.
- Note: Zip code is more accurate. Phone number is not always perfectly accurate, as a prefix can actually be shared across multiple towns, and since people can now take their number with them when they move. NOTE: look-up based on a phone number is unable to retrieve a Zip Code, 00000 is considered a valid zip code and would be used in this case.
Steps to look up location based on phone number or zip/postal code:
- In the Contact Information section, enter a phone number and/or a zip/postal code.
- Click on the "Lookup" button right next to the phone number or zip/postal code.
- The location details (City, County (in North America), State/Province ) will now be auto-populated.
How to use the External Zip or Postal Code Lookup Tool

This feature is only available in version 4 contact forms.
If you have a contact record with location fields enabled, you can enable a tool that allows users to search an external website to find additional zip or postal codes within a specific city or county. This is useful if you prefer your users refer to a specific data set when documenting location information.
An Admin level user at your organization can enable this tool by completing the following steps:
- Click ‘Admin Tools’ in the left side menu
- At the top of the page select the ‘Contacts & Profiles’ tab
- Under the section 'Geographic Settings', there is a text box named ‘URL to external postal code lookup tool, like US Postal Service or Canada Post. When supplied below, a clickable link will appear in the Contact Report entry screen to that URL.’ Enter any URL of your choice in this textbox. The following are not your only options, but they are examples for you to use:
- US Postal Service URL: https://tools.usps.com/go/ZipLookupAction!input.action
- Canada Post URL: https://www.canadapost.ca/cpo/mc/personal/postalcode/fpc.jsf
- Click the 'Save all settings' button
How to use zip/postal code lookup tool:
- From within a contact record with location fields enabled, at the bottom of the Contact Information section, click the link to ‘Zip/Postal code lookup (external)’
- A new tab will open with the website specified by your organization
- Search by county, city, or exact address (depending on the specific tool you are using) to find the zip/postal code
- Copy the zip/postal code
- Go back to the tab with your contact record and paste the zip/postal code into the Contact Information section
When entering or editing a contact record staff have the ability to add or modify attachments in the contact record. This can be useful if you have additional documents that need to be associated with a specific contact record.
An Admin (or someone with security settings that allow them to edit contact forms) can turn this setting on with no additional assistance needed from the iCarol Support Team. To turn this feature on:
- Click "Contacts" on the left side of your screen
- Click "Manage Contact Forms Versions"
- Find the contact form you want to turn this feature on for and click "Edit this form"
- Click "Overall settings for this call report form" at the top of the screen
- Scroll down to the Other Features area and select the box "Attachments can be added to this call report form'
- Scroll down and click "Save Settings"
Now that this setting has been turned on, when you go to enter or edit a contact record, at the bottom of the Finish tab there is a link : Add or modify attachments.
To add or modify attachments to a contact record:
- Click the "Add or modify attachments" link
- A new pop-up window will open where you will choose a file to upload, and enter a Name and Description (optional) for the attachment
- Click the "Add" button
- Add as many attachments as you want to a contact record
- Click the "Close window" button
You will see the attachment name/link and description listed at the bottom of the Finish tab of the contact record.
Once you submit the contact record, the attachment(s) can be accessed from the 'View' mode - just click on the contact record and you will see a link for the attachment directly above the area where you would leave Feedback.
Note: There is no charge to turn this setting on and each iCarol system receives 1000MB of free storage (this includes Contact Record, Resource, and News attachments). Storage can be expanded for an additional fee, however most customers find 1000MB of storage to be enough.
Tips & Tricks for Contact Record Data Entry
How to make a drop-down list selection with your keyboard