Why Add Google Maps Links to SuiteCRM?
Step 1 Create a URL Field for the Map Link
Step 2 Place the Field on the Layout
Step 3 Test the URL Field Manually
Step 4 Create the Workflow
Step 5 Define Workflow Conditions
Step 6 Configure Calculated Field Parameters
Step 7 Build the Google Maps Formula
Step 8 Test the Automation
Practical Use Cases
Final Thoughts
Want to get more out of SuiteAcademy?
Become a member and get access to:
- Workshops
- Courses
- Templates
- Monthly progress calls
Opening an address directly in Google Maps from your CRM may seem like a small feature, but it is one that users appreciate immediately. Whether it is used for route planning, location lookup, distance checks, or mobile field service work, a clickable map link saves time and avoids unnecessary manual steps.
This article explains how to automatically generate a Google Maps link in SuiteCRM using Workflows, based on the address data stored in your records.
Why Add Google Maps Links to SuiteCRM?
There are many practical business scenarios where map links are useful.
- Field service teams can open customer addresses quickly while working on site.
- Sales teams can review account locations and plan visits more efficiently.
- Internal teams can check distances or locations without copying address data into external tools.
- Mobile users can open directions directly from the record view.
- Instead of manually copying addresses, SuiteCRM can generate the map link automatically.
Step 1 Create a URL Field for the Map Link
- First, a field is needed to store the Google Maps link.
- Go to Admin and then Studio.
- Select the Accounts module, or another module that contains address fields.
- Create a new field with the type URL.
- Name the field for example Maps Link, Google Maps URL, or Link to Map.
- Recommended field settings are to open the link in a new window, keep the field optional, disable auditing, and leave the pre generated value empty. The value will be set by the workflow.
- Save the field.
Step 2 Place the Field on the Layout
The field must be visible in the record view.
- Open Layouts and then Detail View for Accounts.
- Locate the Billing Address field group.
- Place the Maps Link field next to the billing address fields.
- SuiteCRM displays billing and shipping addresses as grouped fields. If the address is split into individual fields, for example to use dropdowns for states, the visual grouping will change, but the workflow logic still works the same way.
- Many projects do not require a shipping address, so removing it often helps keep the layout simple.
- Save and deploy the layout.
Step 3 Test the URL Field Manually
At this stage, the field behaves like a normal URL field.
Paste a Google Maps link manually using an address from the record. Google Maps accepts plain address text and usually resolves the location correctly, even if the formatting is not perfect. This flexibility allows the workflow to remain simple.
Step 4 Create the Workflow
- Next, the automation is configured.
- Go to Admin and then Workflow Manager.
- Create a new workflow and name it for example Generate Google Maps Link.
- Select Accounts as the target module.
- Set the workflow to run on save, target all records, and allow repeated runs so the link is updated when address data changes.
- Running on import is optional and depends on whether address data is imported regularly.
Step 5 Define Workflow Conditions
The map link should only be generated when useful address data exists.
Common conditions include the billing street not being empty and the billing city not being empty. Postal code and country can also be included, depending on how strict the data requirements should be.
Even partial addresses such as city and country often work in Google Maps, so the conditions should reflect the project requirements.
Step 6 Configure Calculated Field Parameters
- Within the workflow action, select Calculated Fields.
- Add parameters in a logical order, for example billing street as parameter zero, billing city as parameter one, billing postal code as parameter two, and billing country as parameter three.
- If the workflow contains only one action, using the same name for the workflow and the action can help keep the configuration clear.
Step 7 Build the Google Maps Formula
The workflow now needs to generate the link value.
- Select the Maps Link field as the target field.
- Combine the address parameters into a single text string, separated by commas or spaces. Google Maps can interpret this format without additional encoding.
- An example structure is street, city, postal code, country.
- Save the workflow.
Step 8 Test the Automation
- Save or edit an account record with valid billing address data.
- The Maps Link field should now be filled automatically.
- Selecting the link opens Google Maps and displays the location associated with the account.
- If some records do not resolve correctly, the issue is usually incomplete or invalid address data. Demo data is often randomly generated and may not represent real locations.
Practical Use Cases
Once enabled, this feature supports route planning, location checks, distance estimation, and mobile access for field service and sales teams, without manual copying of address data.
Final Thoughts
This configuration is a small but effective enhancement that highlights the flexibility of SuiteCRM Workflows. By relying on Google Maps to interpret address data, useful functionality can be added with minimal configuration.
To ensure reliable results, address data should be complete, validated, and kept consistent across records. When real data is used, the workflow performs reliably and adds immediate value to daily operations.