Skip to content

Set up a client farm

Create a farm workspace for a grower who isn't on Truleaf Fields yet and manage it from your practice until the grower claims it.

Last reviewed November 2, 2026

If a grower isn't on Truleaf Fields yet, your practice can set up their farm for them. A farm workspace for a grower who isn't on Truleaf yet. You manage it until they claim it. The grower can take it over later. See Hand over a farm to its grower.

If the grower already uses Truleaf Fields, connect to their farm and don't set up a second one.

Before you start

  • Owners, admins and agronomists of the practice can set up client farms. Others see Your role can't add client farms.
  • Confirm your own email address first. Until you do, you see Confirm your email.
  • Your practice's plan sets how many client farms it can set up. That is 1 on the Free plan, no limit during the trial and no limit on the Advisor plan. Only farms nobody has claimed yet count. A farm stops counting once its grower claims it, and farms that connected to you never count. A practice that moves back to the Free plan while over the limit keeps its farms but can't set up new ones.
  • The farm has to be in a country where Truleaf Fields is available.

Create the farm

  1. On the portfolio or the client list, select Add client, then Set up a client farm.
  2. Enter the Farm name.
  3. Check the Country. Starts with your practice's country.
  4. Where is the farm? is optional, so you can leave it empty.
  5. If you have it, enter the Grower's email. Optional: only used to invite them to claim the farm.
  6. Once you enter an email, Send a claim invitation now is ticked. They get an email in their language and can claim the farm within 30 days. Until then nothing is shown to them. Choose the Email language, or untick the box to invite the grower later.
  7. Tick the box confirming that your practice manages this farm's data for the grower until they claim it. Data management terms opens the terms that apply.
  8. Select Create farm.

The box under the form, What happens when you create it, tells you what happens next.

With many farms to set up, use Have a list? to go to Import my clients. See Import your clients.

After you create it

The screen then takes you through Farm details, Who pays and Add fields.

  1. Who pays shows who pays for the farm. A new client farm starts on the Free plan, with 1 field of at most 10 ha. Select Continue.
  2. The summary shows the workspace, your access, the claim invitation and who pays, with a preview of the bar you will see inside the farm. Select Add fields to draw or import its fields now, or Back to clients.

The farm appears in your client list with Not yet claimed. Your practice can edit it, and you work in it like any client farm. See Working in a client farm.

If you are an agronomist and asked for a claim invitation, an owner or admin of your practice gets it first. The summary says Requested. The client list shows when it is sent.

Who pays

Paying for a client farm from your practice isn't available in the app yet, so every farm you set up stays on the Free plan. To cover more fields or hectares for a client, write to support.truleaf@truleaf.org.

Common problems

  • You've reached your client farm limit: your practice has set up as many client farms as its plan allows. Start the free trial or ask about the Advisor plan. See Plans for practices.
  • Truleaf Fields isn't open in this country yet. Choose the country the farm is really in. You can't set up a farm in a country where Truleaf Fields isn't available yet.
  • Your practice's account is read-only. Update payment to add clients. See Payment problems and read-only mode.
  • The data management terms couldn't load. Try again in a moment.
  • Not created. Your entries are still here. Try again in a moment.
  • You're offline. Setting up a client farm needs a connection.

Still stuck?Email support.truleaf@truleaf.org