Credential Policy Manager - Only Available with Plus Plan

Note: This feature is included in select LCvista plans. If you'd like to learn more about access, please connect with your Account Manager.

 

Overview

What the Credential Policy Manager Solves

Basic Configuration Requirements

Lifecycle of a License Compliance Incident

Notifications & Reporting

Advanced Capabilities to Extend Your Setup

 

Overview

The Credential Policy Manager lets you define which licenses or credentials specific groups in your organization must hold, then automatically tracks and manages the resolution process when someone falls out of compliance.

 

What the Credential Policy Manager Solves

Keeping every license and credential your firm requires up to date for every person who needs one can be a manual, reactive process. Someone has to know who's required to hold what, notice when a person falls out of compliance, follow up with them, and track that follow-up through to resolution. The Credential Policy Manager automates that entire cycle.

At a high level, this feature allows you to:

  • Define who needs to hold what. Specify the exact population of professionals required to carry (maintain) a given license or credential, whether that's tied to their role, service line, or their principal place of business.

  • Automatically detect non-compliance. The moment someone in that population is missing a required credential, or their credential expires, the system opens a License Compliance Incident; a single record that tracks that individual’s specific compliance gap from detection through resolution.

  • Route resolution without manual chasing. The affected person is notified automatically and guided toward submitting what's needed; admins get a dedicated place to review, approve, deny, or exempt the request, and no one has to remember to follow up.

  • See it all in reporting. Every incident, every notification sent, and every outcome is tracked and reportable, giving you a clear audit trail of who was out of compliance, when, and how it was resolved.

In short, the Credential Policy Manager turns "who's missing a required credential" from a question your firm has to go looking for, into something the system surfaces automatically, and then helps get resolved.

 

Basic Configuration Requirements

Before the Credential Policy Manager can start opening and tracking incidents, a few things need to be configured. Most firms will only need a subset of this, depending on whether you're tracking credential-based requirements, location-based requirements, or both.

Turn the feature on

The Credential Policy Manager is available to Plus customers. This feature must be enabled by the LCvista Team before any of the configuration below becomes available.

Confirm your Jurisdiction Approval workflow

Every incident is resolved through an approval request, so this needs to be right before anything else. Go to Site Settings > Approval Workflows and confirm the Jurisdiction Approval workflow reflects how you want these requests handled. For example, whether a specific license or credential requires admin approval and whether supporting documents are required.

Decide how you'll define requirements

The Credential Policy Manager supports two kinds of requirement rules, and you can use either or both in parallel:

  • A Credential Requirement: a rule that says a person must hold at least one from a specific list of jurisdictions/licenses.

  • A Work Location Requirement: a rule that says a person must hold whatever license corresponds to wherever they practice, based on a person field you designate (for example, a "Work Location State" custom field). The system will suggest a mapping from each location value to the jurisdiction that satisfies it, with the ability for the firm to modify before saving; this will ensure that as people move between offices or states, their requirement automatically follows them.

Set up Credential Sets

If you plan to write a rule like "must hold an active CPA license in any of these 50+ states," or if you are often searching for a bundle of jurisdictions, then consider defining a Credential Set (for example, "US CPA License"). Doing so will group the relevant jurisdictions together. This saves you from manually selecting every jurisdiction each time you build a rule, and the same Credential Set can be reused later for filtering notifications and reports.

Set up Work Location mapping (if using Work Location Requirements)

  • Go to the Work Location Mapping settings found within Site Settings and License Compliance Settings.

  • Choose one or more existing custom person fields as source fields (the fields whose values represent "where this person works"). As an example, "Work Location State," and optionally "Previous Work Location State" for people transitioning between locations.

  • Once source fields are selected, the system lists every distinct value currently found in those fields across your people, along with how many people currently have that value, so you can map each one to the jurisdiction it should require. Unmapped values are visually flagged so nothing slips through.

  • Any location value you leave unmapped simply doesn't generate a requirement; it isn't treated as an error.

Turn on notifications

Decide which notifications you want active for this workflow (see Notifications & Reporting for the full list) so affected people and admins are actually alerted once incidents start being created.

Build your dynamic groups and attach rules

Create (or identify) the dynamic groups that represent the populations you need to track. For example, "All CPA-licensed staff" or "Partners in Service Line Tax" where custom profile fields like Service Line or Rank are used to define this segmentation. On the group's rules page, within the License Compliance Rules tab, attach one or both of the following:

  • A Credential Requirement rule (standard OR logic across a jurisdiction list or Credential Set), or

  • A Work Location Requirement rule, which automatically applies the mappings configured in Work Location Mappings to that group's members.

A group can have more than one rule attached. For example, one Work Location rule and one Credential rule, and each is tracked as an independent compliance status for the member.

Once these steps are in place, the Credential Policy Manager is ready to run. Advanced Capabilities to Extend Your Setup covers optional enhancements: custom approval request fields, dashboard widgets, and managed-user permissions that you can layer on once the foundational features are in place.

 

Lifecycle of a License Compliance Incident

A License Compliance Incident is the record that tracks one person's specific compliance gap, from the moment it's detected to the moment it's resolved. Here's how it moves through the system, and what each audience sees along the way.

Detection

Whenever a person's relevant data changes (group membership, a custom field value, or a credential (jurisdiction) being added, modified, or expiring) the system re-evaluates that person against every rule assigned to their groups. If they don't meet a rule, an incident opens in a Pending Resolution status, linked to the specific rule and group that triggered it.

User exposure

  • The affected person receives an initial non-compliance notification letting them know they're out of compliance and why.

  • They can see the open incident on their own My Incidents tab, showing what's required, what's missing or expired, and its current status.

  • From the incident, they take action: for a missing or expired credential, they submit a jurisdiction add/modify request, which creates an approval request tied back to the incident, and the incident status moves to Resolution in Progress.

  • If a rule requires multiple credentials (for example, two mapped work locations), the incident stays open until all required credentials are satisfied; resolving one doesn't close it on its own.

  • If a submission is denied by an admin, the incident reverts to Pending Resolution so the person can try again.

  • Managers with the appropriate permission (more on this here) can view, and in some cases act on, incidents belonging to the people they manage.

Admin exposure

  • Admins see all open incidents in an incident list, filterable by status, rule type, and group, and searchable by person, with each incident's age visible for prioritization.

  • An incident's detail view shows the rule that was violated, the specific compliance details (what's missing/expired), any linked approval request(s), and a full resolution timeline (opened, notified, submitted, status changes, assignment history).

  • From the standard Approval Requests menu, admins can approve, deny, or return a submission for revision, same as any other approval request. A denial automatically reopens the associated incident.

  • Admins can also grant an exemption directly from an incident, resolving it without requiring the person to obtain the credential.

  • Approval requests tied to compliance incidents are visually distinguished in the Approvals table, and can be filtered separately using a "Show only license compliance incidents" filter, with a quick link back and forth between the incident list and the approval request list.

  • Where enabled, admins can assign a specific team member to review an incident's approval request; that assignment is visible on the approvals table and reportable.

 

 

 

Resolution paths

An incident can close for more than one reason, and the specific reason is tracked for reporting:

  How it resolves

  What triggers it

Credentials corrected

The person's approval request was approved and the credential was added/updated

Rule exemption granted

An admin granted an exemption for that person against that rule

Rule updated

The rule itself was changed or removed so it no longer applies

Membership changed

The person left the group the rule was assigned through

 

Reminders along the way

While an incident (and its linked approval request) is open, reminder notifications can go out to both the person and admins; see more below in Notifications & Reporting.

 

Notifications & Reporting

Once the basics are configured, these are the tools you'll use day-to-day to stay on top of open incidents.

Notifications

All of the following are configurable, choose which to activate and customize timing where noted.

  Notification

  Recipient

  Trigger

Initial non-compliance notification

Affected professional

Triggered when a new incident is opened for that person

License incident user reminder

Affected professional

Reminder based on how many days their license incident has been open without action

License expiration notification

Affected professional

Sent a configurable number of days before (or after) a held license/credential expires

Approval request user reminder

Affected professional

Reminder based on how many days their approval request has been open without a decision

Approval request approved

Affected professional

Their approval request was approved

Approval request denied

Affected professional

Their approval request was denied

Approval request review required

Affected professional

Their approval request was sent back by an admin for revision

Approval request submitted for approval

Admin(s)

A person submits a request that needs admin review

Approval request admin reminder

Admin(s)

Reminder based on how many days a submitted request has awaited review

 
Notification templates support tokens for the specific rule/requirement that triggered the incident, so recipients see what's actually required of them rather than a generic message.

Reporting

  • People report: reviews custom field information on a person's profile, including any license compliance rule and their current status.

  • License Compliance report: returns one row per user/jurisdiction relationship, with the standard ability to segment by custom fields and jurisdiction fields. This report focuses on the information that lives on the jurisdiction level and is not specific to a CPE requirement.

  • Approval Requests report: all approval requests, segmentable by status, who submitted, who reviewed, when, and assignment.

  • Notification Log report: tracks every notification the system has triggered, useful for reconstructing the full timeline of a specific incident (when someone became non-compliant, when they responded, when it was approved).

  • License Compliance Incidents report: a purpose-built, incident-level report that reports directly off incidents rather than approval requests. It includes: date the incident opened, non-compliant type, days non-compliant, the group/rule that generated it, admin notes, date/content of the last employee response, number of follow-ups, who it's assigned to and when, any approval-request custom field values, a count of open resolution requests (for incidents with more than one in flight), the jurisdictions still outstanding, the resolution reason, and exemption status. Filterable by group, date range, days non-compliant, assigned-to, status, and rule.

 

Advanced Capabilities to Extend Your Setup

Once the basics are running, these optional capabilities add more control and visibility:

Dashboard Widgets. End users can see an "Open Incidents of Non-Compliance" widget summarizing their own unresolved incidents, and (where configured) an "Upcoming License Expirations" widget. Managers with the appropriate permission see a parallel widget summarizing unresolved incidents across the people they manage. These are useful for surfacing open items proactively, rather than requiring someone to go looking for them.

Managed-User Permissions. Four distinct roles govern what a manager or delegate can see and do for the people they manage:

  Role

 Can view managed  users' pending  incidents

 Can act on (submit  for approval)  managed users'  pending  incidents/approvals

 Can view managed  users' Jurisdictions  tab

 Can submit/edit  managed users'  jurisdiction requests

License Incident (Read Only)

Yes

No

Yes

No

License Incident (Read/Write)

Yes

Yes

Yes

Yes

Jurisdictions (Read Only)

No

No

Yes

No

Jurisdictions (Read/Write)

No

No

Yes

Yes

 
These roles can be combined as needed or issued as standalone; for example, a manager could hold a Jurisdiction role for a scenario where the manager should only have exposure to the credentials that user has. Or alternatively, they could hold a License Incident role to act on behalf of the individual to resolve the open incident. These permissions are meant to be useful for firms who want managers to help track compliance for their teams without granting broader admin access.
 

Approval Request Assignment. Where enabled under Approval Workflow settings, an incident's approval request can be assigned to a specific admin or team member for review, visible as a tag on the approvals table and reportable. Useful for firms that split review responsibility across a licensing/compliance team.

More Filters on the Approvals Table. Admins can filter the approvals table by the organization's own custom fields (for example, "show me all requests where Service Line = Tax"), in addition to the standard status and incident-type filters.

Credential Sets, reused. As covered earlier in this document, a Credential Set built for rule-writing isn't limited to that use; the same set can be used to filter notifications and reports, so a single named grouping stays consistent everywhere it's referenced.

Custom Fields for Approval Requests. Beyond the built-in approval request fields, firms can define their own custom fields directly on an approval request. For example, a “self-attestation” field used to document a professional’s confirmation that the data entered is accurate and has been reviewed. You control who can see or interact with each custom field by persona, and any values selected are captured in reporting for after-the-fact tracking and audit. This is useful if your firm needs to document firm-specific context on how a case was handled, beyond what's captured out of the box. See more information on specific setup in the section directly below.

Custom Fields for Approval Requests

Approval request custom fields are configured from the same admin page used for person custom fields, and is accessible through Site Settings within the Custom User Fields tab. When enabled, the Custom Fields tab will display two subtabs: Person Fields and Approval Request Fields each with its own search, active/inactive filter, and reorder controls. All setup below happens on the Approval Request Fields tab.

  • Create the field. Click Add Field to open the add/edit form and define:

    • Label – the display name shown to users and admins.

    • Key – auto-generated from the label but editable until the field is saved; once created, it's locked for edits.

    • Field Type – text, paragraph text, choice list, date, or number. Choice list fields expose an additional sub-input for defining the list of choices.

    • Default Value and Help Text – optional, same behavior as person custom fields.

    • Status – Active/Inactive toggle; inactive fields are excluded from reorder mode and won't appear on the approval workflow.

Once a field is saved, its key, field type, and (if applicable) choice values become permanent; only the label, help text, default value, status, and display configuration can be edited afterward.

  • Configure where and how the field displays. Each field includes a Display Configuration section with a collapsible panel per context:

    • Confirmation and Resolution Modal: set a display state (editable, read-only, or hidden) per approval action (Approve, Deny, Return for Review, Waive, Close for admins; Submit, Acknowledge for users). Only the performer of a given action can see a state configured for it.

    • History Table: set a read-only or hidden state independently for admins and users, since history is a record view rather than an action.

Each context also requires selecting which workflows (e.g., Add Jurisdiction, Modify Jurisdiction, License Compliance Incident) the field applies to; a field with no workflow selected for a context won't appear there. Any action left at "hidden" is simply omitted from what's saved, keeping the stored configuration lean.

  • Set the display order. Field order in both the approval UI and reports follows the order on the Approval Request Fields tab. Click Reorder to enter a dedicated reorder mode (this clears search/filters and shows only active fields with drag handles); drag fields into place and click Done Reordering to save. Inactive fields are automatically appended to the end of the list and aren't reorderable, since their position isn't meaningful while hidden.

  • Manage existing fields. Use the status filter (defaults to Active) and search box to locate a field for editing. Editing an existing field preserves its key and type — you can only update label, status, help text, default value, and display configuration.

Custom fields for approval requests are optional, but for firms that use them, having your fields, display rules, and ordering configured means the Credential Policy Manager captures exactly the information your firm's approval workflow requires.

 

Have additional questions about configuring the Credential Policy Manager for your firm? Reach out to the Customer Success team.

 

Related to