Skip to main content

AI Forms: Automatic Field Mapping Guide

Automatically update client profiles when they submit AI Forms. Map goals, weights, body fat %, and compliance status directly into the Trainerize Clients table.

Written by Xenios Charalambous
Updated over a month ago

Field Mapping allows FitMetrics to automatically update client profile fields when they submit an AI Form — no manual data entry required. For example, if a client submits "180 lbs" as their current weight, their Starting Body Weight updates instantly inside Trainerize Clients.

What Can Be Auto-Filled?

Number Input Mappings

  • Starting Body Weight

  • Goal Weight

  • Starting Body Fat %

Single Choice Mappings

  • Goal

  • Compliance Status

How to Set Up Field Mapping

Step 1 — Create Your AI Form

  1. Go to AI Forms

  2. Click Create New Form

  3. Add a form name

Mapping Number Input Fields

Use this for weight and body fat fields.

How to configure:

  1. Add a Number Input element

  2. Write your question:
    ​"What is your current weight?"

  3. Choose Unit (lbs/kg or %)

  4. Set Min/Max (recommended)

  5. Click Auto-Fill Client Field

  6. Select one of:

    • Starting Body Weight

    • Goal Weight

    • Starting Body Fat %

  7. Save

Automatic Unit Conversion

If your business uses lbs and client enters kg, FitMetrics automatically converts it.

Example: Client enters 80 kg → Stored as 176.4 lbs

Mapping Fitness Goal (Single Choice)

How to configure:

  1. Add a Single Choice element

  2. Add options like:

    • Lose weight

    • Build muscle

    • Get stronger

  3. Click the Goal mapping button

  4. Map each option to:

    • Weight Loss

    • Muscle Building

    • Strength Training

    • General Fitness

    • Body Recomposition

    • Lean Bulking

    • Athletic Performance

    • Maintenance

    • Contest Prep

    • Rehabilitation

    • Consistency

  5. Save

Mapping Compliance Status (Single Choice)

Perfect for weekly check-ins.

Common Setup:

  1. Add a Single Choice element

  2. Question:
    ​"Does any of the following apply to you this week?"

  3. Add options and map each to a status:

    • None of the above → Active

    • I need to pause my program → Paused

    • I'm on vacation → Vacation

    • I'm on a business trip → Business Trip

    • I have an injury → Injury

    • I'm feeling sick → Sick

    • I'm considering cancelling → Cancelling

    • I'm on my menstrual cycle → Menstrual Cycle

  4. Click the Compliance Status mapping button

  5. Map each option

  6. Save

Pro Tip: Always include a "None of the above" → Active mapping.

"Apply Statuses to Current Week" Toggle

When you set up compliance status mapping, you will see a toggle labeled Apply statuses to current week.

  • Toggle OFF (default): The status is applied to the week from the form link's URL (the ?week= parameter). This is best for check-in forms where the form link corresponds to a specific week.

  • Toggle ON: The status is applied to the current week (the week the client actually submits the form). This is useful when clients may submit late or when the form is not tied to a specific week.

This prevents past-week submissions from overwriting the client's current compliance status when the toggle is enabled.

Common Use Cases

1. Onboarding Form

Map: Starting Body Weight, Goal Weight, Starting Body Fat %, Fitness Goal. Ideal for brand new clients.

2. Weekly Check-In Form

Map: Compliance Status. Enables automatic status tracking (Vacation, Sick, Injury, etc.)

3. Progress Review Form

Map: Current Weight, Updated Goal Weight, Updated Goal. Useful for monthly/quarterly reviews.

4. Lead Capture Form

Map: Current Weight, Goal Weight, Fitness Goal. Combine with automations to create Trainerize clients instantly.

5. Vacation / Break Notice Form

Map: Compliance Status → Vacation, Paused, Business Trip, Sick, etc. Great for pausing coaching workflows automatically.

Advanced Tips

Tip 1 — Map Multiple Fields in One Form

You can map Weight, Goal Weight, Goal, Body Fat %, and Status all in one form. All update at once on submission.

Tip 2 — Combine With Automations

Use mapping + automations to assign programs, send messages, or change stages automatically.

Tip 3 — Always Make Mapped Fields Required

Ensures consistent data.

Tip 4 — Use Client-Friendly Language

Example:

  • "Get lean and toned" → Body Recomposition

  • "Build muscle without fat" → Lean Bulking

Tip 5 — Keep Forms Focused

Use separate forms for onboarding, check-ins, and reviews.

Important Notes

  • Field mapping overwrites existing values

  • Mapping only works for the supported fields

  • Only Single Choice and Number Input elements support mapping

  • Mapping happens instantly after form submission

  • Mapping requires the client to exist in Trainerize

Testing Your Mapping

  1. Submit the form as a test client

  2. Go to Trainerize Clients

  3. Enable relevant columns: Starting Weight, Goal Weight, Starting Body Fat %, Goal, Compliance Status

  4. Confirm fields updated correctly

If not:

  • Ensure mapping is enabled

  • Ensure values are valid

  • Ensure client exists in Trainerize

  • Refresh browser

  • Re-test

FAQ

Q: Can I map to custom fields?
Not yet — only the listed fields are supported.

Q: Can clients use kg if my business uses lbs?
No — AI Forms follow whatever unit preference is set in your business.

Q: What if the client submits the form twice?
Latest submission overwrites the previous values.

Q: Can I map multiple questions to the same field?
Yes — last submitted answer is the one saved.

Q: Can I disable mapping?
Yes — click the mapping button again → select "Don't auto-fill."

Q: Do checkboxes work with mapping?
No — only Single Choice and Number Input support mapping.

Related Articles
Customize Client Panel: How to Show More Info on the Client Header
How to Bulk Add Starting Weight & Starting Body Fat
Understanding the Goals Tab: Nutrition, Habits, Body Composition & Scheduler
Custom Fields: Add Extra Client Info to the Tracker
Body Composition: Weight %, Body Fat %, and Plateau Indicator
Did this answer your question?