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

  1. Download Humanform-Excel-Manifest.xml below.
  2. Open Excel desktop (Windows or Mac) and create or open a workbook.
  3. Go to Insert Add-ins Upload My Add-in (on Mac: My Add-ins first, then upload).
  4. Select the downloaded manifest file.
  5. On the Home tab, open Humanform Humanform to show the task pane.
  6. 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 manifest

Formulas

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.

Literal arguments
=HUMANFORM.HUMANFORM("Stature", "Female", 34, 50, "US", "cm")
Cell references
=HUMANFORM.HUMANFORM(A2, B2, C2, D2, E2, F2)

Each call maps to POST /v1/predict with the same request body as the REST API:

Request body
{
  "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.

ScenarioCredit impact
First time a distinct input combination runs1 credit or 1 free-tier call
Same formula inputs, cache hit (within ~6 hours)No additional API call
Input cell changes to a new combination1 credit or 1 free-tier call
Hundreds of genuinely different rowsLegitimate 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.