Integration
Use Humanform inside Microsoft Excel
Tolerance stacks, BOMs, spec sheets, and sizing tables still run on Excel in many automotive and industrial design teams. The =HUMANFORM.HUMANFORM(...) custom function calls the same prediction API as the REST endpoints, with the same credits and measurement set. Download the manifest, sideload the add-in once, save your API key in the task pane, and write formulas like any other cell function.
Setup
- Download
Humanform-Excel-Manifest.xmlbelow. - Open Excel desktop (Windows or Mac) and create or open a workbook.
- Go to Insert → Add-ins → Upload My Add-in (on Mac: My Add-ins first, then upload).
- Select the downloaded manifest file.
- On the Home tab, open Humanform → Humanform to show the task pane.
- Paste a key from the dashboard and click Save API key.
Your API key is stored in the add-in on your device. It is not written into workbook cells or embedded in the manifest.
manifest.xml
Download the Office add-in manifest, then upload it in Excel. The add-in loads from Humanform's hosted servers. No local install or developer setup required.
Download manifestFormulas
Excel requires a namespace prefix for add-in custom functions. Use HUMANFORM.HUMANFORM, not bare HUMANFORM. The function takes six arguments: measurement, gender, age, percentile, country, and unit (mm, cm, or in). It returns the predicted numeric value. Browse supported names on the measurements page and country codes on the countries page.
=HUMANFORM.HUMANFORM("Stature", "Female", 34, 50, "US", "cm")=HUMANFORM.HUMANFORM(A2, B2, C2, D2, E2, F2)Each call maps to POST /v1/predict with the same request body as the REST API:
{
"measurement": "Stature",
"gender": "Female",
"age": 34,
"percentile": 50,
"country": "US",
"unit": "cm"
}Credits and recalculation
Billing is unchanged from the REST API: one successful prediction costs one credit, or uses one free-tier call when you have no paid credits. There is no separate spreadsheet billing model.
| Scenario | Credit impact |
|---|---|
| First time a distinct input combination runs | 1 credit or 1 free-tier call |
| Same formula inputs, cache hit (within ~6 hours) | No additional API call |
| Input cell changes to a new combination | 1 credit or 1 free-tier call |
| Hundreds of genuinely different rows | Legitimate usage: one call per distinct combination |
Free tier: 10 successful predictions per rolling 24-hour window when you have zero paid credits. Purchase credits in the dashboard or wait for the window to reset.
Recalculation: HUMANFORM.HUMANFORM is not volatile. Excel recalculates it when its arguments change, not on every unrelated edit. Reopening a workbook can sometimes rerun custom functions; the built-in cache avoids duplicate API calls for identical inputs within about 6 hours.
Recommended workflow: build your table with formulas, then copy the result range and use Paste Special → Values when the table is finalized. This removes live formulas and prevents accidental extra calls later.
Use cases
- Sizing tables: fill percentile columns for multiple measurements in one sheet.
- Tolerance stacks: pull population dimensions alongside mechanical tolerances.
- Spec sheets: keep anthropometric targets next to product requirements your team already maintains in Excel.
Explore
Browse datasets: full measurement list, supported countries, design examples, plugins roadmap, REST API docs, or MCP server install, or CLI install, or Google Sheets install, or Excel install.