Custom Map Object Setup

Geopointe can map nearly every Salesforce object, including custom objects and less common Salesforce objects. Popular Salesforce objects (Accounts, Contacts, Leads, Cases, and Opportunities) are already ready for mapping, but you will need to take special steps for other objects.

In this document, we will show you how to:

  • Create fields to prepare objects for mapping
  • Create a Map button for record pages
  • Create a Map Records button for object list views
There are three different ways of mapping a custom object: Off Record, On Record, or Referencing. The most common will likely be Off Record, but we'll help you with the instructions for each below.

Don't know which one to pick? Check out the main Map Objects doc for a definition of each.

Off Record

If you were to try and setup a custom object, this error message would prevent you from doing so:

This error comes up because the app could not locate its lookup reference field. For preconfigured objects, it’s placed there automatically; for other objects, you need to create it yourself. Here’s a brief walkthrough of those steps.

1. Create new fields for the objects.

For a custom object: In Setup, navigate to the Build section, click Create | Objects, then click the object name (do not click Edit). Scroll down to the Custom Fields and Relationships section and click New

For a standard object: In Setup, click Customize, select the corresponding Object, and click Fields.

Note: If you're using Lightning interface, complete these steps inside the Object Manager. 

2. Select Lookup Relationship and click Next.

3. Select Geopointe Geocode from the Related To drop down, then click Next.

4. Enter in a Field Label (Geocode would be fine) which typically populates the Field Name. You don’t need to change anything else on this screen. Click Next.

5. Leave the field as visible and editable to all Profiles (there’s no need to lock anything down because they’ll only see Geopointe if they have a license). Click Next.

6. Check the box to add the Geocode field to your page layout. If you’re using Enterprise or Unlimited editions of Salesforce, this step is unnecessary unless you want it visible. Keep the box checked if you are on Group or Professional. Like standard objects, having this field on the layout is how Geopointe has the ability to communicate with the object. Click Next.

7. Do not add any related lists for the field. Uncheck those boxes and click Save.

Once you have completed these steps, your new field should appear in the Fields section for that object.

Lightning Interface:

Classic Interface:

8. Navigate back to the Geopointe Setup tab and try configuring the custom object again. Walk through the basic steps of creating a map object. When you reach the address portion, you’ll notice that nothing has been populated for you.

9. Add your address fields by clicking [change]. More information on selecting these fields can be found in the Map Objects overview.

What now?

Take some time to integrate your custom map object with Salesforce, by creating custom buttons and embedded maps.


On Record

The directions for On Record geocoding for a custom object are no different than any other object, and you can follow the directions on the On Record Geocoding document, or watch the video below. 

Remember, On Record geocoding stores the lat/long values on the parent record instead of via a look-up field. It also saves you storage space over the Off Record method.



The directions for Referencing a custom object to another mapped object is no different than any other object, and you can follow the directions on our main set up doc. The video of those directions are below.

As a reminder, referencing another Map Object allows you to use the geocodes already created for another object. If you are going to use an address accessed via a look-up field, this is likely the setup you will want.


What now?

Take some time to integrate your custom map object with Salesforce, by creating custom buttons and embedded maps.