ZenotiHelp

Custom Metric β€” Number of Current Patients

ZTZenoti Docs Team Updated September 20, 2026 6 min readGuide

The Number of Current Patients metric tracks how many patients have been active within the last 45 days from a selected date. Use this metric in your metrics dashboard to monitor the size of your active patient base at any point in time.

Audience: Business owners and center managers who monitor patient activity and set center-level or employee-level goals in ezPulse.

Before you begin

  • You must have access to ezPulse. Sign in at https://ezpgateway.zenoti.com using your Zenoti credentials.
  • The Number of Current Patients metric must be enabled in your organization's metric configuration. If you do not see this metric in the metrics dashboard or goal creation wizard, contact your administrator to verify that it is active in the metric preferences.
  • Confirm which time period you want to view. This metric supports Today, WTD (week-to-date), MTD (month-to-date), QTD (quarter-to-date), and YTD (year-to-date) views.
  • Your organization's week start day determines the start boundary for WTD calculations. This setting is configured at the organization level in ezPulse settings.

Note: The metric catalog in ezPulse is predefined. You cannot create custom metrics or modify the definition of existing metrics. The Number of Current Patients metric definition is managed in the backend.

Steps

Understand how the metric is calculated

Before using this metric in a goal or reviewing it on the metrics dashboard, understand its counting behavior:

  1. The metric counts patients who had at least one visit or activity recorded within the 45 days ending on the selected date.

  2. The count is a point-in-time value β€” it represents the active patient window as of a single date, not a sum of activity across a period.

  3. When you view the metric under a time period view, the 45-day lookback window is anchored to the end date of that view:

    Time period view Lookback anchor
    Today Today's date
    WTD The current date within the week
    MTD The current date within the month
    QTD The current date within the quarter
    YTD The current date within the year
  4. Because the metric is a point-in-time count rather than a period sum, the value does not accumulate across the time period. The number you see reflects the rolling 45-day window as of the anchor date, regardless of which time period view is selected.

Important: Do not interpret the WTD, MTD, QTD, or YTD values as totals of new patients gained during that period. Each value is a snapshot of the 45-day active window anchored to the current date within the selected view.

View the metric on the metrics dashboard

  1. Sign in to ezPulse at https://ezpgateway.zenoti.com.
  2. Navigate to the Metrics Dashboard for your center.
  3. Select the time period view β€” Today, WTD, MTD, QTD, or YTD β€” using the time period selector.
  4. Locate the Number of Current Patients metric card.
    • The value displayed is the count of patients active within the 45 days ending on the current anchor date for the selected view.
  5. To compare across centers or employees, use the ranking view. For details, see Employee & Location Rankings.

Note: Metric data is refreshed by the backend on a scheduled basis. The value you see reflects the most recent data refresh, not a real-time count.

Use the metric in a center-level goal

  1. From the ezPulse home screen, navigate to the Goals section.
  2. Select Create Goal and choose Center-level goal.
  3. In the goal creation wizard, select the metric Number of Current Patients from the metric list.
    • This metric appears in the Visits category of the metric catalog.
  4. Select a time period β€” Week, Month, Quarter, or Year.
    • For weekly goals, the start date is automatically aligned to your organization's configured week start day.
  5. Enter a target value for the goal. Because this metric is a count (integer), enter a whole number representing the patient count you want to reach.
  6. Complete the remaining goal definition fields and save the goal as Draft or publish it directly.

Tip: Because the metric is a point-in-time count, set your target value to reflect the patient base size you want to maintain or grow to β€” not the number of new patients you expect to add during the period.

Use the metric in an employee-level goal

  1. From the Goals section, select Create Goal and choose Employee-level goal.
  2. Select Number of Current Patients from the metric list.
  3. Assign the goal to one or more employees at the center.
  4. Enter a target value per employee in the goal definition table.
  5. Select the time period and date range, then save or publish the goal.

For full details on creating and managing goals, see Goal Creation.

Worked example

Example: Your center wants to ensure it maintains at least 200 active patients at any point during Q3. You create a center-level goal with the metric Number of Current Patients, time period Quarter, and a target value of 200. On August 15, a manager checks the QTD view on the metrics dashboard. The value shown β€” for example, 187 β€” means that 187 patients had at least one recorded activity between July 2 and August 15 (the 45-day window ending on August 15). The goal progress reflects how close the center is to maintaining 200 active patients as of that date.

Tips

  • Use the MTD view for a monthly check-in on patient retention. Because the 45-day window extends beyond a single month, the MTD value captures patients who were active in the current month and up to 45 days prior.
  • When setting a target value for this metric, review historical values from the metrics dashboard before committing to a number. This helps you set a realistic and meaningful target value.
  • If you manage multiple centers, use the location ranking view to compare the Number of Current Patients across centers side by side. See Employee & Location Rankings.
  • For employee-level goals using this metric, consider whether the 45-day window aligns with your employee's typical patient interaction cycle before assigning target values.

Troubleshooting

The Number of Current Patients metric does not appear in the metric list.

The metric may not be enabled in your organization's metric configuration. Ask your administrator to check the metric preferences in ezPulse settings and confirm that Number of Current Patients is active. See Metric Configuration.

The metric value seems lower than expected.

The 45-day lookback window is anchored to the current date within the selected time period view β€” not to the start of the period. If you are early in a month or quarter, the window may not yet include patients who were active before the 45-day cutoff. Review the anchor date logic in the Understand how the metric is calculated section above.

The WTD value does not match the expected week boundary.

Weekly boundaries in ezPulse are determined by your organization's week start day setting. If the WTD anchor date does not align with your expected week start, confirm the week start day with your administrator. This setting is organization-level and applies to all centers. See Organization Settings.

The metric value has not updated since yesterday.

Metric data is refreshed by the backend on a scheduled basis β€” there is no user-triggered refresh. If the value appears stale beyond the expected data refresh window, contact your Zenoti administrator or ezPulse support.

I created a goal using this metric but the progress bar is not updating.

Confirm that the goal is in Published status. Goals in Draft status do not display live progress. If the goal is published and progress is still not updating, verify that the data refresh has completed for your center.

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