Kavi® Members Help
Table of Contents
Workflow-backed software automates business tasks by encoding and enforcing business rules and processes, then electronically routing the right information to the right people at the right time. The membership workflow ensures that memberships move through well-defined membership processes before they are approved and become current, that applicants are notified when their membership applications are received and when bills are issued, and administrators are notified when membership applications are submitted for their approval. Automated membership workflow enhances visibility into the membership process throughout Kavi Members, including User Tools and Admin tools, member rosters and directors, reports and logs.
The membership workflow consists of states and transitions that define the membership process from the time a membership application or renewal request is submitted until the membership expires and is finally archived. The workflow is configurable, so approval may be gated by billing and moderation steps or other prerequisites, or the membership may be automatically approved, immediately passing through these steps.
Membership state information is used to gate user access and privileges throughout the organization's Kavi-hosted website. Workflow-backed scheduled email can go out to members and administrators throughout the membership lifecycle.
Back to topThere is a basic, predefined workflow for processing new membership applications and membership renewals. Configuration options allow organizations to tailor how their memberships move through the process, but the workflow is common to all organizations. The basic workflow includes billing and moderation steps, but the Super Admin can configure the order in which these steps occur in the organization's memberships and whether each step is enforced in a specific membership type.
Figure 20.1. Standard Membership Workflow

This diagram shows the general order of states in the membership workflow. Each membership starts out in the 'New' state, passes through all other states and terminates in the 'Archived' state. The exception is a membership that is rejected by a moderator and immediately deleted.
Before a new or renewed membership becomes current, it has to pass a series of tests that gate approval. This includes checks to make sure the membership has been paid for and approved by organization moderators, and the scheduled start date has been reached. For each membership type, the organization can decide what kind of membership fee should apply and whether the membership should be moderated or not. If a membership type is neither billed nor moderated, memberships of this type automatically pass billing and moderation tests and move immediately into the 'Approved' state.
The organization also decides the order in which its memberships pass through the billing and moderation steps, and whether fee payment is required for a membership to go active or not. The workflow for renewed memberships is defined independently of the new membership workflow. This gives organizations a great deal of flexibility in defining their membership acquisition processes.
Once the membership acquisition and renewal processes are defined, Kavi Members workflow-backed technology ensures the defined process is always followed, transparently supporting organization staff in membership management, minimizing the risk of inadvertent deviations from organization membership rules.
Back to topThe table below describes all the states in the standard membership workflow and the tests a membership must pass to move on to the next state.
Table 20.1. Membership Workflow States
| State Name | Definition | Destination State |
|---|---|---|
| Start | Memberships enter the 'Start' state as soon as they are added to pending memberships tables in the Kavi Members database. A membership enters the 'Start' state when a potential member submits an application for new membership, when an existing member submits a membership renewal request or when an administrator adds or renews a membership manually. | Once a membership enters the 'Start' state, it may go through the moderation step then the billing step, or the billing step first then the moderation step, depending on configuration. |
| Pending Moderation |
When a membership enters the 'Pending Moderation' state it is sent for moderator approval or automatically passes if this is an unmoderated membership type. If this membership type is moderated, control over the membership workflow passes from Kavi Members to a human moderator (e.g., Organization Admin) who is responsible for applying organization rules. If this membership was added through an online application form, the application is placed in a moderation queue and the moderator is informed by a scheduled email notification. When a membership is added manually, the administrator can approve the membership immediately or send it to the moderation queue. Moderator approval may be contingent on the receipt of signed legal forms or formal acceptance of the application by the organization's board of directors. |
If the Kavi Members workflow was configured to send memberships through the moderation step first, an application that passes the moderation step moves to the 'Pending Bill Payment' state. If the workflow was configured to send memberships for billing first, memberships that pass the moderation test move to the 'Approved' state. If a moderator rejects the membership, it moves directly to the 'Rejected' state and is automatically deleted. |
| Rejected | Membership state is set to 'Rejected' if the membership fails the moderation test. Memberships don't rest in the 'Rejected' state, but are immediately deleted. A record of the membership remains in the Full Activity Log. | Rejected memberships do not move to other states. |
| Pending Bill Payment | Memberships in this state are issued a membership bill unless the membership type is free, in which case the membership automatically passes this test. If there is a fee for this membership type, the membership may remain in the 'Pending Bill Payment' state until the bill is paid or may pass this test regardless of bill payment status, depending on global membership configuration settings. If configured to pass this step regardless of payment status, memberships can go on to the next workflow state and eventually become current even though there are membership bills outstanding. | If the workflow is configured to send memberships through the moderation step first, memberships that pass the billing test move to the 'Approved' state. If the billing step is first first, the membership moves to the 'Pending Moderatation' state. |
| Approved | 'Approved' memberships have successfully passed moderation and billing steps. Memberships don't rest in the 'Approved' state, but move directly to the 'Pending Start Date' state. | 'Approved' memberships go to the 'Pending Start Date' state to test whether they should go current immediately or not. |
| Pending Start Date | Memberships in the 'Pending Start Date' state are tested to see whether they can go current immediately or whether their Start Date is in the future. If the membership is set to start on the current date, it passes through this step and becomes 'Current'. If the membership start date is in the future (e.g., this is a renewal), the membership will remain in the 'Pending Start Date' state until the scheduled Start Date. | Memberships in the 'Pending Start Date' state become 'Current' on their Start Date. |
| Current | Memberships in the 'Current' state went into effect on the Start Date of the membership term and will remain in this state until the End Date of the membership term. While the membership is 'Current' the membership holder is active and the member is assigned whatever types are conveyed through the membership, conferring roles and access privileges. | 'Current' memberships enter the 'Expired' state on the membership term End Date. |
| Expired | Memberships enter this state immediately after the End Date of the membership term. All 'Expired' memberships eventually move to the 'Archived' state. If a membership is renewed before its End Date, it moves immediately to the 'Archived' state. If it is not, it may be archived immediately but if the membership type is configured to have a grace period, the membership remains in the 'Expired' state until the grace period elapses. | If this membership is renewed, it's state is set to 'Archived' as the new membership goes current so that that any types assigned through the old membership are removed when they should be and do not overlap in a renewal scenario. Most organizations allow a grace period between a membership's expiration date and the day when the membership is archived and membership benefits are officially revoked. The membership rests in the 'Expired' state during this grace period. Expired memberships are moved to the Archived state once the grace period has elapsed. For more information on membership expiration and archiving, see Configuring Membership Expiration Rules. |
| Archived |
The 'Archived' state is the final state of a membership. Archived memberships are retained for historical records, but do not actively convey benefits to the member. Types are always revoked from the member when the membership is archived, and this revokes roles that grant access to protected areas of the website. Archived memberships remain in the system as part of a member's membership history. |
Once a membership is archived it doesn't change state. |
Back to top
Messages indicating membership state are displayed on the My Account and My Company pages, as well as Admin Area tools and reports. Here are some examples of end-user messages about membership state.
Table 20.2. Membership workflow state messages
| State Name | Message | |
|---|---|---|
| Pending Bill Payment | Link to pay bill is displayed at the top of the page. Below the membership is the message "Please pay for this membership by clicking the 'Pay Bill' link above." | |
| Pending Moderation | Displays custom message set through Membership Types configuration tools in the Super Admin area, or default text "Your request is being reviewed. If you have any questions, please contact: $org_admin_email. Thank you, $org_name Administration." '$org_admin_email' is the email alias or address of the Organization Admin, and '$org_name' is the name of the Organization Admin. | |
| Current | "Your membership is current. You can now log in to the Members Area to manage your membership. If you need a new password, visit the Password Help page to have a login link sent to you by email." | |
| Expired, Archived | "Your membership has expired. Visit the Renew Membership online form to renew your memberhsip now." |
Back to top