# NewVariantComponentInput

input type

Create-input for a VariantComponent. The tenant (org group) is derived SERVER-SIDE from the principal — NEVER supplied here; variantId (the HOST — rides the header) and componentVariantId are tenant-scoped server-side; the host must be non-doomed and kit/bundle-typed, the component ACTIVE and coupling-admitted (kit ← simple only; bundle ← simple | service | kit — the NAMED gates).

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the constant 'VariantComponent' (a composition edge carries no merchant code); when supplied it must be non-blank. |
| `variantId` | [ID](/types/#scalars) `ID!` | yes | The HOST (kit/bundle) Variant id. |
| `componentVariantId` | [ID](/types/#scalars) `ID!` | yes | The COMPONENT Variant id — immutable after birth; self-composition refused. |
| `quantity` | [Int](/types/#scalars) | no | Whole units per ONE host unit (1..1000000) — defaulted to 1 when omitted. |

## Used by

- [createVariantComponent](/reference/variant-component/createVariantComponent/)