---
title: "ElementVersion"
description: "The `ElementVersion` entity."
section: "Reference"
group: "Types"
order: 74
---

## Definition

```ts
interface ElementVersion {
  id: string;
  elementId: string;
  name: string;
  parentId: string | null;
  status: "pending" | "failed" | "ready";
  error: string | null;
  exportName: string | null;
  bundleVersionId: string | null;
  createdAt: string;
  updatedAt: string;
}
```

## Fields

| Field             | Type                               | Notes                                                                                                                                                                                                                                                      |
| ----------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`              | `string`                           | `readonly` `required`                                                                                                                                                                                                                                      |
| `elementId`       | `string`                           | `required` — Element this version belongs to.                                                                                                                                                                                                              |
| `name`            | `string`                           | `required` — Version label (e.g. 'v1', 'experiment').                                                                                                                                                                                                      |
| `parentId`        | `string \| null`                   | `required` — Version this one was forked from; null for the initial version.                                                                                                                                                                               |
| `status`          | `"pending" \| "failed" \| "ready"` | `required` — R2-hydration lifecycle. 'pending' while source files are being forked from the parent version, 'ready' once buildable, 'failed' if hydration errored.                                                                                         |
| `error`           | `string \| null`                   | `required` — Error from hydration (set when status = 'failed').                                                                                                                                                                                            |
| `exportName`      | `string \| null`                   | `required` — Named export of the bundle this version renders. Null = `default`. Set when one bundle exposes multiple MDX tags (e.g. Card family).                                                                                                          |
| `bundleVersionId` | `string \| null`                   | `required` — Alias: FK to another element_version that owns the actual bundle. Null = this version owns its own bundle. Non-null = the renderer fetches the referenced version's bundle instead, enabling sub-primitive tags to share one compiled source. |
| `createdAt`       | `string`                           | `readonly` `required` — ISO-8601 timestamp of creation.                                                                                                                                                                                                    |
| `updatedAt`       | `string`                           | `readonly` `required` — ISO-8601 timestamp of the last update.                                                                                                                                                                                             |