Documentation

Getting started with PoultryDesk

From your first sign-in to entering real farm figures, in about 30 minutes.

Last updated 2026-07-11

Getting started with PoultryDesk

Welcome. This guide takes a brand-new user from a fresh sign-in to entering real farm figures in about 30 minutes. It is written for the person setting up the farm for the first time.

Everything here happens under your own subdomain ({slug}.poultrydesk.com). For a one-page map of where each screen lives, see the Navigation cheat-sheet.

Before you start

You need three things:

  • The web address for your organization: {slug}.poultrydesk.com.
  • Your sign-in email and password (or an invite link if someone invited you).
  • A phone for daily farm entries and a laptop for setup and reports.

You do not need to install anything. PoultryDesk runs in the browser. On a phone you can add it to your home screen for an app-like experience, but that is optional.

The 30-minute setup, in order

1. Sign in and check the organization profile

Confirm the organization name, contact details, time zone, and currency. These feed dates and money formatting everywhere else, so get them right once, now. The subdomain is fixed and cannot be changed later.

2. Build your locations

Your flocks are placed inside poultry houses, so the physical structure comes first. Create your sites (farms or premises), then add the poultry houses inside each site. Enter each house's capacity and floor area accurately - area is used later to split shared costs fairly.

3. Invite your team and set roles

Invite people and give each the narrowest role that lets them work: Worker for farm staff who enter daily production figures, Manager for someone who runs the farm day to day, and Owner for the one or two people who run the business and billing. Roles are enforced on the server, never just hidden in the UI.

4. Add your first flock or egg set

Choose Place a Lot and add a broiler flock, layer flock, or hatchery egg set to one of your houses. PoultryDesk uses Lot as the common name for these managed groups. Enter its placement date and bird count. This becomes the baseline for mortality, feed conversion, and cost per bird.

5. Enter your first daily figures

This is the habit that makes everything else work. From a phone in the poultry house, record mortality, feed, and (for layers) eggs. When you submit, the entry saves on the device immediately and shows a queued badge - you do not wait for the network. It syncs in the background when a connection is available.

6. Record the money

Record a sale and an expense. For a cost shared across several flocks, pick an allocation method and let the engine split it.