Deep Links

Deep links let you copy a URL to the exact page or patient-facing destination you need.

In circleOS, these links usually live in Copy share link inside the Action Menu on supported detail pages. Not every page exposes share links, so the submenu only appears where that page has been wired for sharing.

circleOS links

Use Copy share link → Copy circleOS URL when you want to send a link to another staff member.

This copies the current admin page you are already looking at. circleOS keeps the current locale, path, and query string from the browser address bar, then combines that with the configured admin base URL for the current deployment.

Examples:

• https://os.circle.health/patients/3434
• https://os.circle.health/bookings/123
• https://os.circle.health/settings/services/42

The exact host depends on the current environment.

Patient App links

Use Copy share link → Copy Patient App URL when the destination should open in the patient-facing app instead.

This option only appears on pages that provide a patient destination. Depending on the record, circleOS either:

• builds a patient-app route directly from the current resource
• uses that record's saved public detail URL when one exists

Common current examples include:

• https://app.circle.health/appointments/123
• https://app.circle.health/plans/{planId}
• https://app.circle.health/documents/42
• https://app.circle.health/diagnostics/{labOrderId}
• https://app.circle.health/book/services/42
• https://app.circle.health/book/variants/123
• https://app.circle.health/product-variants/167/checkout

In day-to-day use, patient-facing links are commonly available for bookings, active plans, published documents, diagnostic results, services, service variants, and product variants. On a few admin pages, the patient-facing link can point to a related patient document rather than to the admin record itself.

circleOS uses the configured Patient App base URL for the current environment. If the destination is a relative patient-app route, the current locale and query string are carried across. If the destination is already a full URL, circleOS keeps that URL's own query parameters and only adds missing ones from the current page.

When the Patient App option is missing or disabled

Some records only support an internal circleOS link.

The patient-facing option can also be unavailable until the record is ready to share. Common examples include:

• documents that are not published yet
• plans that are not active yet
• pages that only support an internal admin route
• product detail pages, which do not currently expose a patient-facing route
• records that do not have a patient-facing destination at all

If Copy Patient App URL is disabled or not available, use the circleOS URL for staff, or finish the publishing, activation, or sharing step first.