Great field operations start with clear guidance

What this guide covers

This guide explains how to maintain clean customer records for Create and Manage Contacts. It is written for the current JobsiteOn implementation and avoids assumptions about unshipped behavior.

Before you begin

• Confirm you can access the relevant route(s) for this workflow.
• Use sandbox first when testing a new process or policy update.
• Keep this article open while you execute each step so your team can follow one consistent path.

Workflow overview

1. Open the correct route and confirm workspace context.
2. Complete the core workflow action in order.
3. Validate downstream impact before handoff.
4. Document exceptions and close the loop with your team.

Step 1: Open the correct route and confirm context

Start from /contacts and confirm you are operating in the intended workspace and environment.

Route checklist

• /contacts
• /contacts/new
• /contacts/[slug]

Step 2: Complete the core workflow action

Follow the route sequence above from first screen to final save/submit point. Avoid skipping fields or intermediate review states during first-pass execution.

• /contacts/new now saves through the live contacts API instead of a frontend-only draft flow.
• The street-address field now searches existing properties first and then Google Places results, and selecting a result fills street, city, state, ZIP, and line 2 when available.
• Selecting an address suggestion now commits on the first click or tap instead of requiring repeated selection attempts before the dropdown closes.
• The Associated Properties picker on /contacts/new now shows the property name first and the full saved property address on the second line instead of only the city/state pair.
• The contact detail route /contacts/[slug] now reflects the saved contact address from creation, so the Address card keeps the street and locality information after save and reload.
• You can still type the address manually when the desired location is not in suggestions.

Step 3: Validate downstream impact

After the main action completes, verify that related modules reflect the update. Confirm the saved contact reopens with the same address details you entered, especially if you selected an address suggestion instead of typing every field manually, and verify the Address card on /contacts/[slug] still shows that saved address after reload. The expected downstream impact for this area is accurate job, quote, invoice, and inbox linkage.

Step 4: Handle exceptions quickly

If the expected result does not appear:

1. Refresh the current page and confirm the record status.
2. Verify required linked entities (contact/property/team/job/invoice context as applicable).
3. Re-run the action in sandbox if live-state confidence is low.

Step 5: Keep the process repeatable

Capture the final operating sequence for your team and reuse this article as the reference runbook. When behavior changes, update this article in the same change set as the product update.

Validation checklist

• Primary route opened successfully.
• Core action completed without blocking errors.
• Downstream module behavior matches expected workflow.
• Team handoff information is complete.

Troubleshooting

I cannot access one of the listed routes

Confirm account permissions and environment selection. If access is still blocked, route the issue to your admin/support path with the exact URL.

I saved changes but I do not see the result

Reload the route, confirm linked records, and validate whether this workflow is beta-gated in your workspace.

My screen layout looks different

Layout can vary by feature flags or viewport size. Keep following route names and workflow checkpoints from this guide.

FAQ

Is this available in every workspace?

This guide documents generally available behavior in current production routes.

Should we run this in sandbox first?

Yes. Sandbox-first execution is recommended for process changes and first-time team rollout.

How often should this process be reviewed?

Review whenever related auth/onboarding/module/release behavior changes.

Notes

This article covers currently available behavior in active production routes.

Related Articles

• Create and Manage Properties
• Create and Send Quotes