Skip to main content

Create a ballot: title, questions and preview

Build a ballot in two steps: write the title, description and questions, then preview what owners will see.

M
Written by Michael Bollinger

Build a ballot in two steps: write the title, description and questions, then preview what owners will see. The ballot stays a Draft until you send it, so nothing reaches owners while you work. Voting settings, recipients and the invitation email come next, on the ballot's page. See Ballot settings, recipients and sending.

Before you start: you need Voting write permission. See Give board members and staff access.

Start a ballot

  1. Click Other Tools → Voting.

  2. Click New.

  3. In "Ballot or survey?", choose Ballot, then click Continue with ballot.

The Create ballot page opens at step 1, Ballot.

Note: PayHOA saves the draft as soon as the page opens. If you leave without filling it in, an Untitled ballot draft stays on your Votes list. Delete it if you don't need it (see Delete a draft you don't need).

Your changes save as you type ("Changes saved automatically"). If a save fails you'll see "Auto-save failed. Your last change may not be saved." Check your connection and make the change again.

Add the title, description and attachments

  1. Under Ballot title and description, type the Ballot name. Owners see it in their email and on the ballot.

  2. Optional: type a Ballot description, for example the meeting date, what the vote is for and how the result will be used. Line breaks, **bold** and lists (start a line with "- ") show as formatting.

  3. Optional: click Add attachments to add files owners can open from the ballot, such as candidate statements, the proposed budget or the amendment text.

To remove an attachment, delete it and click Delete attachment to confirm.

File types and size for ballot attachments

A ballot attachment must be a PDF or an image (JPG, PNG or GIF), and each file can be up to 100 MB. Word, Excel and other file types aren't accepted: you'll see File type '.docx' is not allowed … Allowed types: jpg, jpeg, png, gif, pdf. Save the document as a PDF and add that instead. A file that's too big shows {file name} exceeds the 100 MB limit.

Owners open attachments from the ballot's page, where each one opens in a new browser tab. Attachments aren't sent with the invitation email. The only file on that email is the PDF preview of the ballot's questions, which PayHOA makes itself.

An attachment won't open

If a PDF or image attached to a ballot won't open or shows an error:

  1. Open the ballot yourself and click the attachment. If it opens for you, the owner's browser is probably blocking the new tab or can't display the file; ask them to allow pop-ups for PayHOA or try another browser or device.

  2. If it doesn't open for you either, open the original file on your computer. A PDF that is damaged, password-protected or still marked as a different file type won't open after upload.

  3. Save a fresh copy as a PDF (for example Print → Save as PDF), delete the attachment on the ballot and add the new copy. You can only change attachments while the ballot is a Draft. Once it's sent they're locked, like the questions; send the corrected file to owners another way, for example with a Broadcast email.

  4. If a fresh copy still won't open, contact PayHOA support with the ballot's name, the file's name, who can't open it and a screenshot of the error.

Add a question

A new ballot starts with one empty question card, Question 1.

  1. Type the Question, for example Do you approve the 2027 budget?

  2. Choose a Type. See the table below.

  3. For Single choice, Multiple choice and Ranking, type each Choice. Click Add another choice for more. You need at least two choices.

  4. For Multiple choice, set Maximum selections: the most choices one voter can pick. Leave it empty to let voters pick any number.

  5. Leave Required on if every voter must answer. Turn it off to make the question optional.

  6. Click Add another question for the next question.

Type

Owners

Use it for

Yes / No

Pick Yes or No

Approve a budget, an amendment or a single candidate

Single choice

Pick one choice

One seat with several candidates, or one option among several

Multiple choice

Pick up to the Maximum selections

Several seats from one list of candidates

Ranking

Put the choices in order

Ranked preferences

Text

Write an answer

Comments or a write-in candidate

Amount

Enter a dollar amount

Suggested amounts, for example for a contribution

File upload

Upload a file, up to 15MB

A signed form or supporting document

A question is complete when it has a question, a type and, for choice types, at least two choices. A complete card shows a Done link.

For election setups, such as several seats or a single nominee, see Run an election.

Note: picture-choice questions aren't available on ballots. Add the images as attachments and refer to them in the choices.

Tip: other screens name some types differently. The ballot's page shows Ranking as Ranked choice and Yes / No as Yes or no. They're the same types.

Show a question only after a certain answer

From the second question on, you can ask a question only when a voter gave a certain answer to an earlier one. For example, ask Which design do you prefer? only when a voter answers Yes to Should we repaint the clubhouse?

  1. On the later question, turn on Show only when.

  2. Under Earlier question, pick the question it depends on.

  3. Under Is answered, pick the answer that shows it.

The folded card reads "Shown when Q1 is Yes", for example.

The earlier question must be a Yes / No or Single choice question, saved, and above this one. If none qualifies, you'll see "Add a saved yes/no or single choice question above this one first."

Voters who don't see a conditional question don't need to answer it, even if it's Required. Results for that question are out of the people who answered it.

If you delete or move the earlier question, or change its type or answers, PayHOA removes the condition and the question shows to everyone.

Reorder, duplicate or remove questions

  • Reorder: drag a question by its handle (Drag to reorder).

  • Duplicate: click the duplicate icon at the bottom of the card.

  • Remove: click the delete icon, then confirm in "Delete this question?". If other questions depend on it, the message says so, and those questions will show to everyone.

Preview the ballot

  1. Click Continue. It's available once the ballot has a name and every question is complete.

  2. Step 2, Preview ballot, shows the ballot as owners will see it: the title, description, attachments and each question, with conditional questions marked.

  3. Click Back to change something, or Save and continue to go to the ballot's page.

The ballot is still a Draft. Its page shows a Ready to send checklist for the voting settings, recipients and invitation email. See Ballot settings, recipients and sending.

To check the ballot on paper, open the ballot's page and click Actions → Download PDF preview. Owners get the same preview attached to their invitation.

Leave and come back

Click Exit at any time. Your work is saved.

To pick up where you left off, open Votes and click the draft. A draft you haven't finished opens the questions again. A draft you've previewed opens its page; click Edit questions on the Questions card to change the questions.

You can change the questions only while the ballot is a Draft. Once you send it, the questions are locked. See Fix a mistake.

Delete a draft you don't need

  1. On Votes, click the Draft tab.

  2. Click ⋯ on the draft's row, then Delete.

  3. In "Are you sure you want to delete this draft ballot? This cannot be undone.", click Delete ballot.

You'll see "Ballot deleted."

Troubleshooting

You see

What to do

"Failed to start a new ballot. Please refresh and try again."

Refresh the page and click New again. Check that you have Voting write permission.

"Auto-save failed. Your last change may not be saved."

Check your connection, then make the change again.

"Could not save the question. Please try again."

Make the change again. If it keeps failing, refresh the page.

"Could not save the options."

Your choices didn't save. Type them again, or refresh the page.

File type '.docx' is not allowed … Allowed types: jpg, jpeg, png, gif, pdf

A ballot attachment must be a PDF, JPG, PNG or GIF. Save the document as a PDF and add it again. See File types and size for ballot attachments.

A PDF attached to the ballot won't open or gives an error

Open it from the ballot yourself, then replace it with a freshly saved PDF. See An attachment won't open.

Continue is greyed out

Add a Ballot name, and finish every question: a question, a type and at least two choices where needed.

Several Untitled ballot drafts on your list

Each click on New → Ballot saves a draft. Delete the ones you don't need.

What's next

Did this answer your question?