ZenotiHelp

Service-Grant-Aware Provider Scheduling Priority

ZTZenoti Docs Team Updated October 25, 2026 5 min readGuide

Availability: This feature is in Beta. Contact your CSM to enable AI Scheduling (Demand based Scheduling) for your center.

The AI Employee Scheduler ranks providers in the Schedule Grid to help you understand which providers the scheduling model considers most schedulable for a given day. When your center uses service grants to restrict which providers can perform certain services, the scheduler automatically adjusts provider priority so that providers who cannot be scheduled — because they hold no service grants and have no open services to fall back on — are never ranked above providers who can be scheduled.

This article explains how that adjustment works and what you see in the Schedule Grid as a result.

Audience: Managers who review AI scheduling suggestions and manage provider service grants.

Before you begin

  • AI Scheduling (Demand based Scheduling) must be active for your center. If you do not see the Schedule Grid, contact your CSM.
  • You must have access to the Schedule Grid to view provider scheduling priorities.
  • To understand how service grants are configured at your center, contact your administrator or refer to your organization's service-assignment settings.

Note: If your center has not uploaded a provider-services extract, the scheduler runs in service-blind mode and treats all providers as equally schedulable. The priority adjustment described in this article does not apply in that mode.

Steps

Understand how service grants affect provider ranking

When the scheduler builds a suggested schedule, it assigns each provider a priority rank displayed as a #N badge in the Schedule Grid. This rank reflects the order in which the model selected — or deprioritized — providers within their scheduling tier.

Service grants affect that rank in a specific way:

  1. Open the Schedule Grid for the relevant center and calendar week.

  2. Locate the #N priority badge next to each provider's name in the Schedule Grid.

  3. Identify providers whose badge number is higher (lower priority) than you would expect based on their past utilization or scheduled hours.

    A provider may be ranked lower than peers in the same tier if:

    • They hold no service grants for the services the model is trying to schedule, and
    • There is no open (ungated) service at your center that any provider can perform regardless of grants.

    When both conditions are true, the scheduler treats that provider as effectively unschedulable for the day and moves them below grant-holding peers in the scheduling priority.

  4. Review the provider's service assignments outside the Schedule Grid to confirm whether the ranking reflects a genuine service-grant gap.

Understand where the ranking adjustment applies

The service-grant priority adjustment is not limited to the visual badge. It is consistent across three parts of the scheduling model:

Where it applies What it controls
Scheduling model cost function Which providers the model selects first when building the suggested schedule
Edge-trim ordering Which providers lose hours first when the model trims supply to match demand
Schedule Grid #N badge The priority rank displayed to you for review

Because all three use the same ordering, the badge you see accurately reflects the model's internal decisions — a provider ranked #4 in the grid was also the fourth candidate considered by the model and the fourth in line to have hours reduced.

  1. If you disagree with a provider's ranking because you know their service grants are correct, use the in-product feedback tool to flag the issue for review.

Interpret rankings when service-blind mode is active

If your center has not provided a provider-services extract, the scheduler cannot determine which providers hold service grants. In this mode:

  1. All providers in a given scheduling tier are treated as equally schedulable.
  2. The service-grant adjustment does not apply.
  3. Priority within a tier is determined by past utilization only — providers with higher past utilization are ranked above providers with lower past utilization.

Service-blind mode produces valid schedule suggestions, but those suggestions do not account for which providers are actually qualified to perform the services in demand on a given day.

Tips

  • Check service-grant assignments before acting on a low ranking. A provider ranked unexpectedly low may have incomplete service-grant records rather than a genuine scheduling constraint. Verify their assignments before adjusting the suggested schedule.
  • The ranking is a scheduling input, not a performance rating. A high #N number means the model deprioritized this provider for schedulability reasons — it does not reflect the provider's skill, experience, or value to the center.
  • Use the ranking alongside the day-level coverage summary. If a day is labeled Understaffed and several high-ranked providers are unavailable, check whether lower-ranked providers are deprioritized due to service-grant gaps — that combination may explain why the model cannot close the gap.
  • Provide a provider-services extract to get grant-aware rankings. If your center currently operates in service-blind mode and you want the scheduler to account for service grants, contact your CSM to arrange the extract upload.
  • Trim ordering follows the same priority sequence. If you are wondering why a specific provider's hours were suggested for reduction (a Reduce hours recommendation) before another provider's, the service-grant ranking is part of that explanation — lower-ranked providers lose hours first within the same tier.

Troubleshooting

A provider I expect to be highly ranked appears with a high #N number.

Check whether the provider has service grants assigned. If the center uses service grants and this provider holds none — and no open services exist — the scheduler will rank them below grant-holding peers in the same tier. Verify their service assignments, then run an on-demand recompute to see an updated ranking.

All providers appear to have the same relative ranking regardless of service grants.

Your center may be operating in service-blind mode (no provider-services extract is present). In this mode, service grants are not considered and all providers in a tier are ranked by past utilization only. Contact your CSM to provide a provider-services extract if you want grant-aware rankings.

The #N badge ranking does not match my expectation based on who was scheduled.

The priority badge reflects the model's internal selection order at the time the scheduling run was generated. If provider availability, service grants, or schedules have changed since then, run an on-demand recompute to generate a fresh ranking against current data.

Was this article helpful?
Your feedback helps us improve our documentation.