# Proactive Hints for SaaS & Web Apps | Adoption Layer

> Trigger contextual guidance across enterprise tools and SaaS: guide employees through business rules and eliminate data entry mistakes.

## The right prompt in the right place, the moment users hesitate.

Trigger contextual hints based on URL, idle time, or on-screen DOM state. Replace forgotten training sessions and intrusive popups with clear, in-flow guidance.

## Data entry errors and hesitation cost teams valuable hours.

An employee mistypes an entry in SAP, an account rep misses a required field in Salesforce, or a new user lands on an empty dashboard without knowing where to begin. Complex business procedures are easy to forget without in-context guidance. Sending reminder emails or scheduling refresher training rarely prevents in-the-moment errors. A subtle contextual hint delivered at the point of action guides users without disrupting their flow.

- **Errors made before they can be prevented**: A forgotten business rule leads to rejected tickets, back-and-forth support friction, and delayed approvals.
- **The empty screen hesitation**: Faced with an empty dashboard or an unconfigured module, employees stall and drop off without a clear first action.
- **Mechanical dismissal of blocking popups**: Intrusive modal windows obscure actual work. Users close them immediately out of habit without reading.

## Trigger help only when assistance is truly needed

Combine surgical trigger conditions to intervene in the right place at the right moment, without cluttering the screen.

- **URL and path route triggers**: Target a specific screen, an entire sub-path tree, or explicit query parameters. The hint is ready as soon as the user navigates there.
- **Inactivity detection and timing delay**: Trigger after a fixed delay or as soon as a user stops navigating for a set number of seconds, signaling operational hesitation.
- **DOM screen state and element visibility**: Condition delivery on whether a specific button, empty container, or warning alert is visible in the viewport, without modifying host code.

## Three concrete enterprise use cases

From onboarding new employees to securing high-stakes compliance workflows.

- **Empty dashboard onboarding**: Offer a step-by-step setup walkthrough the moment an employee or customer opens a clean workspace. Remove blank canvas hesitation.
- **Critical form entry guidance**: Highlight required formats, approval thresholds, and mandatory attachments on complex administrative or financial workflows.
- **New feature and process rollout**: Walk users through updated interfaces and new standard operating procedures as soon as they log in, without lengthy webinars.

## Frequently asked questions

### How do proactive hints prevent overwhelming the user experience?

Unlike intrusive popups, an Adoption Layer hint opens gently without stealing keyboard focus or locking the screen. Furthermore, our engine guarantees only one hint can open per page session, eliminating popup fatigue.

### How does arbitration work if multiple rules target the same screen?

The engine enforces a strict URL specificity hierarchy (exact URL with params > section path with prefix > all pages). Within the same tier, the first rule whose trigger conditions become true claims the page. Rules never clash visually.

### Does displaying a hint consume AI interaction credits?

No. Trigger evaluation and initial hint rendering are completely local and rule-based. An AI interaction is only counted if the user deliberately clicks a suggested intent or types a question.

### What happens when a user dismisses a proactive hint?

Dismissing a hint marks it in the browser's sessionStorage. The hint will not auto-reopen on that page during that tab session, but remains accessible if the user manually opens the assistant.

### Can hints target dynamic conditions such as error banners?

Yes. Using the CSS selector trigger, you can condition hint display on whether an alert container, validation error, or empty table state is rendered in the active viewport.

### How do you track the performance and adoption of proactive hints?

The dashboard anonymously tracks displays, dismissals, start rates, and intent popularity. You immediately identify which hints resolve the most friction and improve completion rates.