Service overview pages

Customer-facing service landing pages — templates, link share, and short links.

Service overview pages are styled, single-service landing pages where customers read about an offering, check availability, and start booking — without going through the full customer portal first.

They are hosted on your widgets runtime:

{workspace-id}.widgets.servease.io

(same host as booking widgets, but opened as a dedicated page rather than an iframe embed).

What customers see

Depending on the template you choose, a overview page typically includes:

Service name, description, and pricing hints
Photo or branding from your widget Theme
Availability — calendar, quick dates, or slot list for that service
A path to book (continue into the widget booking flow)

Overview pages are public — anyone with the link can open them. They respect the same published services, schedules, and filters as your widget configuration.

Where overview pages come from

Entry point	What it does
Widget booking flow	When Enable service overview is on in the Widget creator, customers can open Overview from the booking modal (new tab)
Admin → Service detail → Generate page	Build a link for one service with its own template and colours — choices apply to this link only, not saved widget settings
Link share on the page	Visitors on an overview page can copy a short link to share the same page (see below)

Enable for widgets

In {workspace-id}.widgets.servease.io (or Settings → Customer portal widget → Widget section):

Turn on Enable service overview (or “service overview in booking modal”).
Pick a default overview template — used when overview opens from that widget unless overridden per link.

Page templates

Each template changes layout and tone while showing the same service data:

Template	Character
Professional	Structured layout — corporate or clinical brands
Luxury	Spacious hero, refined typography
Simple	Minimal chrome, fast to scan
Friendly	Warm spacing for consumer services
Minimal	Ultra-light visuals, content-first
Bold	Strong headings, high contrast
Nature	Earthy palette, calm hero
Retro	Vintage poster look with bold borders

When generating a link from Service detail → Generate page, you pick the template (and optional colour palette) for that link only.

Generate a link from admin

For marketing campaigns or a single service landing page:

Open Services → select a service → service detail.
Click Generate page.
Choose Colour palette — preset or custom colours (stored only inside the generated link).
Choose Page template.
Show page — opens the overview in a new tab for review.
Copy short link — creates a shareable short URL (recommended for email, SMS, QR codes, social).

Template and palette choices in Generate page do not change your saved service or widget settings. They affect only the link you generate.

When a customer (or you) is viewing a service overview page, most templates include a Share control — for example Share this page, Share link, or Share in the page header or footer.

Clicking Share:

ServEase creates a short link for the current page context (service, template, selected date/slot when applicable).
The short URL is copied to the clipboard (feedback such as “Link copied” appears on the button).

Use this when someone finds a slot they like and wants to send the same overview to a colleague or friend.

From the widget booking modal (before opening the full page), a Copy short link icon in the header does the same without leaving the modal.

Short links vs long URLs

Sharing always ends on your widgets host with a full service-overview URL. For convenience, ServEase offers short links that redirect there.

Shape:

https://{workspace-id}.api.servease.io/o/{code}

{workspace-id} — your tenant / workspace id (same as portal and widgets hosts).
{code} — a short random code (for example a1b2c3d4e5f6).
Host is your tenant API domain (*.api.servease.io), not the widgets host.

When someone opens a short link, the API responds with a redirect (302) to the full overview URL on {workspace-id}.widgets.servease.io. Browsers follow that redirect automatically.

Short links must use the *.api.servease.io host. A path like https://{workspace-id}.widgets.servease.io/o/… does not resolve short links — use Copy short link or Generate page so the correct URL is created.

Identical share payloads reuse the same short code when possible (you may get the same /o/{code} link again).

Long URL (what the redirect opens)

The destination looks roughly like:

https://{workspace-id}.widgets.servease.io/?embed=true&page=service-overview&serviceId=123&tpl=professional&cfg=…

Important query parameters:

Parameter	Meaning
`embed=true`	Widget runtime mode
`page=service-overview`	Service overview page layout
`serviceId`	Which service to show
`tpl`	Overview template (professional, simple, etc.)
`cfg` or `config`	Encoded widget theme/filter payload (colours, language, etc.)
`as`	Optional anchor date (`YYYY-MM-DD`) for availability
`sk`	Optional session key when opened from the same browser session
`handoffSlot*`	Optional slot context when sharing a specific time

You rarely need to build long URLs by hand — use Copy short link, Generate page, or Share this page.

Source	What is saved
Widget creator → Enable service overview + template	Saved in widget config — applies to overview opened from that widget
Service detail → Generate page	Not saved — template and palette live only in the generated short/long URL
Share this page on a live overview	Creates a short link from the current page state (date/slot context when set)

Publish the service and confirm schedules produce bookable slots.
Match widget Filters so the overview shows the intended catalog scope.
Test the short link on mobile — most visitors open shared links on phones.
Regenerate links after major widget theme changes if old shares should pick up new colours.