Documentation Index
Fetch the complete documentation index at: https://docs.decodahealth.com/llms.txt
Use this file to discover all available pages before exploring further.
First-time setup: General Preferences is typically one of the first pages to configure when setting up a new organization. Complete this before inviting staff or scheduling appointments.
Configure Branding
Navigate to General Settings
Click the Settings gear icon in the main navigation menu and select General.
Set Your Practice Identity
Fill in the following fields:
- Practice Name: The display name patients see on receipts, emails, and booking pages.
- Introductory Text: A welcome message shown to patients on public-facing pages. A rich text editor is available for formatting.
- Practice Logo: Upload your clinic logo (PNG, JPG, or GIF, max 5 MB). Drag-and-drop is supported. This logo appears on patient-facing pages and communications.
Changes auto-save about a second after you stop editing — there’s no Save button on this page. A save indicator at the top shows when an update is in progress.
Set the Default Timezone
The Default Timezone is applied to new locations by default. Existing locations keep their individually configured timezone, so changing this value does not retroactively update them.Configure Communication Templates
Decoda sends automated messages to patients at various points in their journey. Customize each template below to match your clinic’s voice and policies.- Reply-To Email: The email address patients see when they reply to automated emails from your clinic.
- CC Email: An email address that receives a copy of all outgoing patient communications. Useful for compliance or administrative oversight.
- Manual Invoice Text: The message included in manually sent invoices. Supports variables:
{first_name},{tenant_name},{url}. - Receipt Text: Message displayed on payment receipts. Variables:
{tenant_name},{url}. - Reservation Cancellation Text: Template for text messages sent when an appointment is cancelled. Variables:
{appointment},{start_time},{first_name},{tenant_name}. - Successful Payment Text: Message shown to patients after a payment is processed.
Configure Invoicing Rules
Control when and how often invoices are delivered to patients.- Max Invoices Per Day: Limit the total number of invoices sent per day across your organization. This prevents overwhelming patients with multiple invoices in a short period.
- Max Invoices Per Minute: Rate limit for invoice delivery (this prevents the system from sending too many at once). Helps manage system load during bulk invoicing.
- Invoicing Hours: Set the start and end time window for when invoices can be sent (e.g., 9:00 AM to 5:00 PM). Invoices queued outside these hours are held until the next eligible window.
- Allow Invoicing on Weekends: Toggle whether invoices are delivered on Saturdays and Sundays.
- Exclude Holidays: Toggle whether recognized holidays are skipped for invoice delivery.
Customize Receipts
Tailor the look and delivery method of payment receipts.- Receipt Logo: Upload a separate logo specifically for receipts. This can differ from your practice logo if needed.
- Automatically Send Receipts: Toggle whether receipts are sent to patients immediately after a payment is processed.
- Default Receipt Communication Method: Choose SMS or Email as the default delivery method for receipts.
- Quote SMS Text: Message sent to patients along with price quotes. Variables:
{first_name},{tenant_name},{url}.
Configure Payment Settings
These options control how payments and billing items are presented to patients and staff.- Pass Fee to Patient: When enabled, the credit card processing fee is added to the patient’s total instead of your clinic absorbing it. For example, a 3% fee on a $100 charge adds $3 to the patient’s bill.
- Hide Patient Payment Plans: Toggle to hide the payment plan option from patient-facing pages. Use this if your clinic does not offer payment plans.
- Auto-Assign Sold By Provider: When enabled, the provider from today’s appointment is automatically set as the “Sold By” provider during checkout. Turn this off if you want staff to pick the selling provider manually each time.
- Item Sort Type: Choose how services and products are ordered in billing views. Options include: Category, Usage, Defined Order, Name, or Price. When Defined Order is selected, a list appears so you can drag items into the order you want.
Dual Pricing
If your clinic uses dual pricing (a separate cash price for certain settlement types), a Dual Pricing panel appears below the payment settings.- Cash Settlement Types: Tick the settlement methods that should bill at the item’s cash price instead of its regular price. Settlement types are managed under payment settings; only the ones you create show up here.
Dual Pricing only appears if it has been enabled for your organization. If you do not see this panel, contact support to discuss whether dual pricing is right for your clinic.
Set the Default Home Page
Under the Navigation section, the Home Page dropdown sets the default page users land on after they sign in. The list is filtered to pages enabled for your tenant — for example, if Marketing is on, Growth-related routes appear; if it’s off, they don’t. This is an organization-wide default. Individual users can still navigate freely once they’re signed in.Configure Patient Settings
Define rules for patient registration.- Required Patient Fields: Select which patient profile fields are mandatory when staff create a new patient. Options include email address, phone number, date of birth, external ID, address, gender, first name, last name, lead source, and credit card on file.
Configure Scheduling
Control how providers are surfaced when staff are picking who performs a service.- Filter Providers by Service: When on, the provider list on the staff calendar only shows staff who are attached to the selected service. When off, every provider is offered, even ones who do not perform that service. Use this if your clinic offers services that only some providers are trained or licensed to perform — it stops the wrong provider from being booked by mistake.
This setting applies to manual booking from the staff calendar. Provider-to-service assignments are managed in Settings > Services on each service’s Providers tab.
Analytics
- Default Accounting Basis: Choose Cash or Accrual as the basis the analytics dashboards open in for everyone. Individual users can still switch their own view for the session without affecting anyone else. See Cash vs. Accrual Accounting for what the two bases mean and when to pick which.
Manage Patient Tags
Create and manage tags used to categorize patients across your organization. From the Patient Tags section at the bottom of the General page, you can add a new tag, edit an existing tag’s name or color, or delete tags you no longer use. Tags created here become available everywhere patients are tagged in the app.Personal Preferences
Per-user settings like theme, calendar display options, notification sounds, and auto sign-off live on a separate page. See Personal Preferences for those settings. Your own Google Calendar connection is managed in Google Calendar.Advanced Configuration
Connecting Google Calendar
Connecting Google Calendar
The Google Calendar integration on the General page connects a single, centralized Google account for the whole organization. Decoda uses this account for appointment events, meeting links, and patient invitations.
- Scroll to the Google Calendar Integration section in General Settings.
- Click Connect Google Calendar and sign in with the Google account you want to centralize on.
- Authorize Decoda to read and write calendar events.
Individual staff members can connect their own personal Google Calendar from Settings > Google Calendar. The centralized account is used for appointment events when it is connected. Provider calendars can be used for appointments in clinics that do not use a centralized calendar.
Session Timeout Configuration
Session Timeout Configuration
The Idle Sign-out Timeout setting controls how long a user can remain inactive before being automatically signed out. Shorter timeouts improve security for clinics where multiple staff share workstations. Toggle it on under Authentication & Session in General Settings, then enter the timeout duration. Turn the toggle off to disable automatic sign-out.
IP Blocking
IP Blocking
For organizations that require strict network security:
- Add allowed IP addresses or CIDR ranges to the list under the IP Blocking section.
- (Optional) Use Exempt Users to pick staff members who should be able to sign in from any IP address — useful for owners or remote admins who travel.
- Toggle Enable IP Blocking on. Once enabled, only users from allowed IP addresses (or those on the exempt list) can sign in.
Permissions
Permissions
Viewing and editing the General page is gated by the broad workspace settings permissions:
- View Settings — Required to open the General page.
- Manage Settings — Required to edit any field on the page. Without it, the page is read-only.
Template Variables Reference
Template Variables Reference
The following variables can be used in communication templates. The system replaces them with actual values when messages are sent.
| Variable | Description | Available In |
|---|---|---|
{first_name} | Patient’s first name | Invoice text, Cancellation Text, Quote SMS |
{tenant_name} | Your organization’s name | Invoice text, Receipt text, Cancellation Text, Quote SMS |
{url} | Payment, receipt, or quote link | Invoice text, Receipt text, Quote SMS |
{appointment} | Appointment details | Cancellation Text |
{start_time} | Appointment start time | Cancellation Text |
