Approvals are a formal voting tool in OnBoard that lets boards capture votes quickly and keep a clear record of outcomes.
| Explore more through the Approvals course and others in the OnBoard Academy - link: Approvals |
Creating a New Approval
How Do I Create a New Approval?
To create a new Approval, you will start in Actions, then choose Approval as the new Action type.
- In the left navigation, click Actions.
- Click Create New (top right).
- Select Approval.
- Click Create Approval.
After you create it, OnBoard generates a new Approval in Draft status that you can edit until you set it to Open.
Duplicating an Approval
How Do I Duplicate an Existing Approval?
To duplicate an existing Approval, you will start in the Actions list, locate the Approval you want to copy, and use the item’s context menu (often shown as three dots) to create a new Draft copy.
Steps
- Find the Approval you want to copy in the Actions list.
- Open the item’s context menu (commonly a three‑dot menu) next to the Approval.
- Select Duplicate.
- Open the new copied Approval (it is typically created in Draft status) and update key details.
| NOTE: Documents attached to an Approval are not copied over to the duplicated Approval from the original Approval. |
Approval Details
What Information Can I Add to the Approval Details?
In the Approval details, you can add the Approval name, dates (optional), motion details, description, documents, and signature requirements.
Fill in as needed:
- Approval Name
- Open Date and Close Date (optional)
- Motion and Second information (optional)
- Description (optional, but recommended)
- Supporting Documents (optional upload; these are typically the documents up for review/approval)
- Require Signature (optional; requires a user signature with their vote)
| Note: Once the approval is opened, documents uploaded to Approval Details cannot be deleted/removed. New versions of the documents can be uploaded by Admins or Commenters to the Discussion Section. |
Open & Close Dates and Notifications
What are Open and Close Dates, and What Do They Do?
- If you set an Open Date: the Approval can automatically move from Draft to Open when that date/time occurs.
- If you set a Close Date: the Approval can automatically move from Open to Closed when that date/time occurs.
- If you leave both fields blank: you control the timing manually using the Status dropdown (Draft → Open → Closed).
| NOTE: If an Approval is closed prematurely, it CANNOT be set back to Open. |
Should I Use Open/Close Dates or Manage Status Manually?
- Leave Open Date and Close Date blank, then manually Open and manually Close the Approval when you’re ready.
- This helps prevent an Approval from opening before you finish edits.
- This helps prevent an Approval from closing before you receive the number of votes you need.
When is Auto-Opening Useful?
- Voting during a meeting: set an Open Date slightly before the meeting starts so the Approval is ready and you don’t forget to open it.
When is Auto-Closing Useful?
What are Open & Close Notifications, and When Do They Matter?
|
IMPORTANT NOTES:
|
How Do I Set Open & Close Notification Options?
- Click Set Open & Close Notifications.
- Choose your notification options for when the Approval is Opened and Closed.
- Click Save Changes.
| NOTE: For a full list of notification types, see: List of OnBoard Notifications. |
What if I Open the Approval Manually—Will People Still Get Notified?
Permissions and Participants
How Do I Add Voters to an Approval?
To add voters to an Approval, use Manage Voters and assign voting permissions by group or by individual.
- In the Permissions panel, click Manage Voters.
- Add voters by:
- Group, or
- Individual user
- Click the + icon next to a group/user to add them.
- Click the Voter permission to customize further if needed.
Permission Types
Understanding how permissions work in Onboard is critical to allowing you and your organization to access and edit your Approvals. Below is the list of different permissions types for the Approvals action.
| Admin & Voter | Can vote in the Approval and has full edit permissions. |
| Admin | Unable to vote in the Approval, but has full edit permissions. |
| Voter | Can vote in an Approval. |
| Commenter | Can view and participate in Approval Discussions and upload documents to the discussion section. Commenters are unable to vote. Helpful when non-voting, non-admins need to make recommended updates to a document. |
| Exclude | Complete removal of access to the Approval. Overrides all other access. |
Permission Behavior to Remember
- Individual permissions override group permissions.
- Voters receive an email notification after the Approval is marked Open (if notifications are set).
- You can add voters any time before the Approval closes, but voters added after it opens will not get the original email notification and should be notified directly.
| For detailed permission definitions, see your internal reference: OnBoard Master Permission List. |
How Do I Add Commenters to an Approval?
To add commenters to an Approval, assign the Commenter permission so they can join discussions without voting.
- Commenter lets a subject matter expert view and participate in discussion while restricting them from voting.
How Do I Vote if I’m Both an Admin and a Voter?
To vote as an Admin & Voter, cast your vote from the Cast Vote panel once the Approval is Open.
- If your permission is Admin & Voter, you will see Admin features alongside voter options.
| Tip: For a true end-user experience, set up a test account and invite the test user as a Voter. |
Results Display Settings
How Do I Configure How Results are Displayed?
To configure results display, use Configure in the Approval Results section and choose who can see results and what format to show.
- On the Approval details page, find Approval Results.
- Click Configure.
- Select one visibility option:
- Results Visible to Voters (Respondents + Admins)
- Results Visible to Admins (Admins only)
- Choose one or both display types:
- Graphical (anonymous percentages)
- Roll Call (names + votes)
- Click Save.
Additional Considerations:
- Results visibility can be updated at any time (including in closed and finalized states).
- Roll Call shows each participant’s name and vote.
- If Graphical and/or Roll Call are deselected, Approval Admins can still access full results via the downloaded results.
- You may also allow voters to post comments directly on the Approval (if enabled).
Opening an Approval
How Do I Open an Approval for Voting?
To open an Approval for voting, change the status to Open Approval or schedule it to open automatically using the Open Date.
Option A: Open immediately (manual)
- Open the Status dropdown at the top of the Approval page.
- Click Open Approval.
Option B: Open automatically (scheduled)
- Enter a value in the Open Date field.
- When the date/time becomes current, OnBoard will automatically open the Approval and alert voters (based on notification settings).
What Prompts Will I See When Opening?
When opening manually, you will be prompted to confirm and can optionally add a custom message to participants.
- Choose Don’t Notify or Notify to complete the opening process.
| For the voter experience, see: Voting On Approvals & Viewing Results and End‑User Quick Reference Guide. |
Enable Discussion (Comments and Files)
How Do I Enable Discussion on an Approval?
The discussion section can be opened or closed when the approval is open. To enable discussion on an Approval, so Voters, Commenters, and Admins can post comments and add files:
- Click Enable Discussion.
- Click View Discussion to open the discussion panel.
- Users will be able to see the current comments, and any files added to the Approval, and will be able to add files to the Discussion itself.
How Do Files Work Inside Discussion?
Inside Discussion, users can attach files to comments and manage those files using the three‑dot menu.
- Use the three‑dot menu next to a file to: Rename, Download, or Delete the file.
- Users viewing the Approval can see the most recent comment from the Discussion panel.
What Happens to Discussion After the Approval is Closed?
After an Approval is Closed, Discussion will not accept new comments or files, but existing discussion files can still be renamed, downloaded, and deleted.
Sending Reminders
How Do I Send Reminders to Voters?
To send reminders, use Send Reminder while the Approval is Open and choose whether to remind all participants or only non‑voters.
- Confirm the Approval status is Open.
- Click Send Reminder on the Approval Status panel.
- Choose who receives the reminder:
- All participants, or
- Only users who have not yet voted
- Add an optional custom message.
Closing an Approval
How Do I Close an Approval?
The “Closed” state is similar to a “review period” where you can have discussion and work towards the final decision.
To close an Approval, use the Status dropdown and select Close, then confirm because closing cannot be undone.
- If you want OnBoard to close it automatically, enter a Close Date first.
- Otherwise, close it manually:
- Open the Status dropdown.
- Click Closed.
- Confirm you want to close the Approval by selecting "Close Approval" (this step cannot be undone).
- (Optional) Add a custom message to notify participants.
| NOTE: After closing, the Approval becomes locked and participants can no longer cast or change votes. |
Finalizing an Approval
How Do I Finalize Results as Passed, Failed, or Tabled?
To finalize results, change status to Finalized, select Passed/Failed/Tabled, add notes if needed, and click Submit to lock the finalized details.
| NOTE: Approval Results will not be downloadable until the approval is finalized and a decision has been made. |
Downloading Approval Results
How Do I Download Approval Results?
To download results, use the download option after the vote is finalized; results download as a Word document and can include eSignatures if the "Require Signature" setting is enabled.
Vote Retention
What Happens to Vote History if Membership Changes?
If a member is deleted or removed from a voting group, their previously cast votes remain recorded as long as the Approval has been Closed or Finalized.
This ensures your organization always maintains an accurate historical record of voting outcomes, even when membership changes occur.
Plan Information
Approvals are included in OnBoard's Premium Plan, Ultimate Plan or available as an add-on. To add Approvals for your organization contact your Account Manager today.
FAQs
Can I reopen an Approval after closing it?
- No. Once an Approval is closed (even prematurely), it cannot be set back to Open.
Why didn’t my voters get an email when I opened the Approval?
- There are two options for receiving notifications:
- Automatic notifications must be selected for auto-opening and auto-closing Approvals
- Admins must choose to send a notification if manually closing.
- Voters added after the Approval opens will not receive the original email notification and should be notified using the Send Reminder button.
Do Approval Admins receive “opened” and “closed” notifications?
- No. Approval Admins do not receive open/close notifications.
What is the difference between “Voter” and “Commenter”?
- A Voter can cast a vote on the Approval, while a Commenter can participate in discussion but cannot vote.
What is the difference between Graphical and Roll Call results?
- Graphical shows anonymous percentages, while Roll Call shows each voter’s name and their vote.
Can I remove a document I uploaded to Approval Details after opening?
- No. Documents uploaded to Approval Details cannot be deleted/removed once the Approval is opened. New versions can be uploaded by Admins or Commenters in Discussion.
Can I still manage Discussion files after the Approval is closed?
- Yes. After closing, Discussion won’t accept new comments/files, but existing Discussion files can still be renamed, downloaded, and deleted.
How can I see the end‑user voting experience?
- Use a test account as a Voter, and/or reference the member guide: Voting On Approvals & Viewing Results and End‑User Quick Reference Guide.
Can I duplicate an Approval instead of creating a new one from scratch?
- Yes. Duplicating an Approval is a fast way to reuse an existing vote setup when the motion or format are similar.
Do supporting documents copy over when I duplicate an Approval?
- No. Supporting documents attached to the original Approval will not appear in the duplicated Approval.
Comments
0 comments
Please sign in to leave a comment.