Skip to main content

Create a violation

Record a violation against one or more units, set a deadline to fix it, and (optionally) email the owners a notice letter.

M
Written by Michael Bollinger

Record a violation against one or more units, set a deadline to fix it, and (optionally) email the owners a notice letter. You can issue the same violation to several units at once; PayHOA creates a separate violation for each unit.

A new violation takes six short steps: Units, What did you see?, Violation details, Attachments, Notifications and Review. Nothing is saved or sent until you click Issue violation on the last step. Use Back to change an earlier step.

Before you start: You need permission to edit violations. If you don't see New Violation, ask an administrator to update your access. If the page says "Your organization doesn't have the violations module enabled," the module needs to be turned on first.

Step 1: Units

  1. Click Violations in the left menu, then New Violation in the top right.

  2. Tick the box next to each unit this violation applies to, then click Next.

  • Use Search units, owners, emails… to find a unit by address, unit name, owner name or email.

  • Narrow the list with Unit tags, Owner tags or Balance.

  • The counter (for example, 1 of 159 units selected) shows how many you've picked.

  • Click Columns to show or hide columns.

Tip: To write up a single unit, start from that unit's page and click Create violation report. The unit is filled in and this step is skipped, so the wizard shows five steps (Step 1 of 5) and the step numbers below shift down by one.

Note: If you select more than one unit, PayHOA creates one violation per unit. Each one is tracked, fined and resolved on its own.

Step 2: What did you see?

This step is optional. It gives you a head start on the wording; click Next to skip it and write the violation yourself.

  • Describe it. Type what you saw, such as trash cans left at the curb, and click Fill it in. Gable writes the title, message and letter for you.

  • Pick a saved type. Under Or pick a saved type:, click one of the buttons (your first eight types) to start from wording you've used before. If you have no types yet but do have message templates, you'll see Or start from one of your templates: instead.

  • Upload a letter you already send. Drop in a PDF, Word file, text file or photo of your usual letter. Gable turns it into a template.

  • Or, enter it manually goes straight to the next step with a blank form.

You'll see and can change everything on the next step. "You'll preview and approve the violation details before anything is saved."

Note: Fill it in and uploading a letter save the new wording as a violation type and template, so you can reuse it next time, even if you don't issue this violation. You'll see "Saved "Trash cans" as a new violation type with its first template. Next time it fills in by itself." or, after an upload, "Saved your letter as the "Courtesy notice" template for "Trash cans"." Fill it in also sets the Status on the next step to the letter's status (your first one). If your association has no statuses yet, it adds a Courtesy notice status first. To fix a type name Gable got wrong, see Rename, retire or delete a violation type.

Note: If your association has no letters, statuses or templates yet, this step also shows Use the starter set. It adds three statuses, common violation types and a letter for each. See Starting from scratch.

Tip: If you see "Add your CC&Rs and rules to Documents…", click Add documents. With your governing documents in PayHOA, Gable can point to the rule that was broken.

Step 3: Violation details

  • Title (required) — a short name owners will see, such as Parked in wrong parking spot.

  • Header (optional) — text above the message, such as your association's letterhead.

  • Message (required) — the details of the violation.

  • Footer (optional) — text below the message, such as a closing signature.

Click Load a template next to any of them to use saved wording. If your association has a default header or footer, it's already filled in. If you started from a template on Step 2, you'll see "Filled in from your template."

Below the letter:

  • Reported date (required) — defaults to today. Change it if the violation was observed earlier.

  • Resolution deadline (required) — the date the owner must fix it by. It appears in the letter as "Please resolve this violation by: …". It's required even for a courtesy notice; see Can I send a courtesy notice without a resolve-by date?.

  • Status — for example, Courtesy Warning. Leave it as -- for no status. This field only appears if your association has statuses. See Set up violation statuses.

Click Preview at the top of the card to see the letter as the owner will.

Note: The letter shows the unit's title and address at the top. If a unit's title is its street address, the address appears twice. Rename the unit under Units to stop that.

Personalize the message with fields

Click Insert Field in the editor toolbar to drop in details that fill in for each unit, which is useful when you're issuing to several units at once. Fields include balance, past-due balance, unit title, unit address, first name, last name, mailing address, community name, payment link, current date and login qr code.

Typing a field name in brackets, such as [unit address], doesn't fill in. Only fields inserted with Insert Field fill in. The letter already shows the unit's title and address at the top, so you don't need a field for those.

Pressing Enter starts a new paragraph with space after it. For a single line break, for example between the lines of a signature block, press Shift+Enter.

Tip: The AI button in the toolbar can Improve writing, Fix grammar, Make more formal, Make more casual or Summarize. Highlight text to rewrite just that part.

Step 4: Attachments

Optional. Drag photos or documents into the box, or click add files. You can attach up to 10 files per violation; files that are too large are skipped with a warning.

Tags are added on the violation's page after you issue it.

Step 5: Notifications

Email the owners is on by default, and the owners of the units you picked are already ticked, so the violation is emailed as soon as it's issued. Use Search owners and admins or Filter by tag to add admins and others who work on violations, or untick anyone who shouldn't get it.

People without a usable email are greyed out with No email on file or Email is undeliverable. Turn Email the owners off to issue without emailing, for example if you plan to mail the letter or send it later; you'll see "Emails are off".

Step 6: Review and issue

Check the summary: units, email recipients, status, reported and resolve-by dates, and attachments.

  • Violation letter preview shows what owners will get. Turn on Show fields to see where fields fill in.

  • The email says who gets it. View and edit the email changes the email that carries every violation letter, not just this one.

Click Issue violation. You'll see "Violation has been issued." (or "3 violations have been issued." for several units). The new violation appears at the top of the Violations list.

What happens after you issue it

  • Owners can see it right away in their homeowner portal, even if you didn't email them.

  • Nothing is emailed if you turned Email the owners off, and nothing is ever mailed automatically. Forgot to notify? Open the violation and use Actions → Notify, or mail it with Actions → Mail. See Send a violation to owners.

  • Attachments go out with the violation email, up to 10 files, whether you email it now or later with Notify or Email Violations. Status-change and completion emails don't carry them. A violation email can carry 15.3 MB of attachments in total, the same limit as a Broadcast email (a Windows PC shows the same amount as about 14.6 MB); if the files add up to more, the email is stopped and shows as failed. Use smaller photos. See Check whether a violation was delivered.

  • If the violation's type has approvers, the email waits for one of them. You'll see "Sent for approval" and "The letter went to the approvers for this violation type. It goes to the owner once one approves." The violation itself is issued right away. See Have someone approve letters before they go out.

  • To confirm the owner received and opened it, see Check whether a violation was delivered.

Troubleshooting

Message

What it means

Next is greyed out

Finish the step first: pick at least one unit, or fill in the required fields.

Attachments Failed — Issue the violation(s) without it?

One or more files didn't upload. Click Yes, issue to continue without them, or cancel and try again.

Violations were created, but the notification email could not be sent.

The violation was saved. Send it again from the violation's page with Actions → Notify.

What's next

Did this answer your question?