Documentation

Custom domains

Put PoultryDesk on an address you own, such as app.yourfarm.com, and make it the branded home for your team.

Last updated 2026-09-23

Custom domains

Every organization gets a PoultryDesk address the day it is created, such as greenfarm.poultrydesk.com. On the Enterprise plan you can also put PoultryDesk on an address you own, such as app.greenfarm.co.ke, so your team signs in on your own brand.

Setting one up takes three steps: you add the domain, you publish two DNS records to prove you control it, and then you switch it on. Nothing changes for your team until you activate.

Before you start

  • You need the Owner role. Other roles cannot see or manage domains.
  • You need the Enterprise plan. On any other plan the Domains screen shows an upgrade panel instead.
  • You need access to the DNS settings for the domain, either at your registrar or wherever your DNS is hosted. If someone else manages DNS for you, send them the two records from step 2.
  • Use a subdomain you are happy to dedicate to PoultryDesk, such as app. or farm. in front of your own domain. Do not use a domain that already serves your website.

Step 1: add the domain

  1. Open Settings, then Domains.
  2. Under Add a branded address, type the hostname in the Domain box, for example app.greenfarm.co.ke. Enter the hostname only, with no https:// in front and nothing after the domain.
  3. Choose Add domain.

The domain appears in the list below with the status PENDING and shows the DNS records you need.

Step 2: publish the two DNS records

The domain card shows four values. Add both records in your DNS settings exactly as shown.

The first record proves you control the domain:

  • TXT name: _poultrydesk-challenge.app.greenfarm.co.ke
  • TXT value: the long code shown on the card, copied exactly

The second record sends visitors to PoultryDesk:

  • CNAME name: app.greenfarm.co.ke
  • CNAME target: cname.poultrydesk.com

DNS changes are not instant. Most providers publish within a few minutes, but some take a few hours. You can leave the page and come back.

Step 3: verify and activate

  1. Back on Settings, then Domains, choose Verify ownership. PoultryDesk looks up the TXT record and compares it with the code it issued.
  2. If the record has not published yet, you get a message saying it was not found. Wait a little longer and try again. Nothing is lost, and you can retry as often as you like.
  3. Once the check passes, the status becomes VERIFIED. When the CNAME record is also in place, choose Activate domain.
  4. The status becomes ACTIVE and your branded address starts serving PoultryDesk. A secure certificate is issued for it automatically the first time someone visits.

What changes once the domain is active

  • Your team can sign in at the branded address.
  • Invitation emails link to the branded address.
  • If you use SAML single sign-on, the sign-in address your identity provider talks to is the branded one.
  • Your original yourorg.poultrydesk.com address keeps working. Both addresses reach the same organization and the same data.

Two things are worth knowing about running on two addresses:

  • Signing in is per address. The two addresses are separate as far as the browser is concerned, so signing in on one does not sign you in on the other. Pick one address, tell your team to use it, and stay with it.
  • Offline captures stay on the address that made them. If someone captures records offline on one address, those queued records are sent from that address. Opening the other address on the same phone will not show them until the first one has synced. This is another reason to settle on one address for everyone.

Password reset emails and email-confirmation links always use the standard PoultryDesk address. Those links prove who you are to PoultryDesk itself rather than to your organization, so they deliberately never travel through a domain you control.

Turning a domain off

Choose Disable on the domain card. Traffic to the branded address stops within a minute, and your standard PoultryDesk address carries on as normal.

Disabling is permanent for that domain. The record is kept so the address cannot be claimed by anyone else, which also means the same domain cannot simply be added again. If you need to bring it back, contact support.

When something is not working

  • Verification keeps failing. Check that the TXT record name starts with _poultrydesk-challenge. and that the value was copied in full with no extra spaces or quotation marks. Some DNS providers add your domain to the name automatically, so entering the full name produces a doubled name. Enter only the part your provider expects.
  • The address shows a "not active" error. The domain is added but not activated yet, or it has been disabled. Check the status on the domain card.
  • You added the CNAME on your main domain and your website went down. Point PoultryDesk at a subdomain such as app. instead, and restore your original record.
  • You want to use your bare domain, such as greenfarm.co.ke, with nothing in front. This is not supported yet. A CNAME cannot be used at the top of a domain, so use a subdomain for now.
  • You want two addresses, such as app. and www.. Each organization can have one active domain at a time.