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.

Xenios Charalambous avatar
Written by Xenios Charalambous
Updated over 2 months ago

What is Field Mapping?

Field Mapping allows FitMetrics to automatically update client profile fields when they submit an AI Form — no manual data entry required.

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. Click Create New Form

  2. 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 ✨ Auto-Fill Client Field

  4. Select Goal

  5. Map each option to:

    • Weight Loss

    • Muscle Building

    • Strength Training

    • General Fitness

    • Body Recomposition

    • Lean Bulking

    • Athletic Performance

    • Maintenance

    • Contest Prep

    • Rehabilitation

    • Consistency

  6. 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:

    • None of the above → Active

    • 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 ✨ Auto-Fill Client Field

  5. Select Compliance Status

  6. Map each option

  7. Save

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


💡 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, Business Trip, Sick, etc.

Great for pausing coaching workflows automatically.


⚙️ Advanced Tips

Tip 1 — Map Multiple Fields in One Form

Example:

  • Weight

  • Goal Weight

  • Goal

  • Body Fat %

  • Status

All update at once.

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. Enable relevant columns:

    • Starting Weight

    • Goal Weight

    • Starting Body Fat %

    • Goal

    • Compliance Status

  3. Confirm fields updated correctly

If not:

  • Ensure mapping is enabled

  • Ensure values are valid

  • Ensure client exists in Trainerize

  • Refresh browser (this does the trick)

  • 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 — If your business has preferences in "Imperial" system then AI Forms will use imperial system or whatever unit preference you got 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.

Did this answer your question?