> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickterm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Version types & lifecycle

> Understand major vs. minor versions and how template lifecycle states (scheduled, effective, superseded) work.

When you publish a new template version, you choose whether it should be a **major** or a **minor** version. This choice determines how ClickTerm treats the version in terms of user consent and compliance.

<Frame caption="Version type selection">
  <img src="https://mintcdn.com/clickterm/Tkp_GRyJwpuLYp7_/product/images/version-type-selection.webp?fit=max&auto=format&n=Tkp_GRyJwpuLYp7_&q=85&s=c5dbe6a501f5048d5991c9d1c387fb82" alt="Version type selection" width="886" height="1348" data-path="product/images/version-type-selection.webp" />
</Frame>

## First version

<Info>
  The first version of every template is always a **major** version (1.0).
  It becomes the baseline that all users must accept.
</Info>

## Major versions

A **major version** is used when the content changes in a meaningful or legally important way.

When you publish a major version:

* All users must review and accept the updated terms again
* Previous consent no longer applies
* This version becomes the new baseline for future minor versions

**Use a major version when you introduce:**

* Updated Terms & Conditions
* New legal requirements
* Changes in user rights or obligations
* Significant policy updates

Major versions are labeled with whole numbers (e.g., **2.0**, **3.0**).

<Warning>
  Publishing a major version resets the acceptance requirement for all users.
  Your developers may need to handle re-acceptance flows.
</Warning>

## Minor versions

A **minor version** is used for small adjustments that do not require users to re-accept if they already accepted the latest major version.

When you publish a minor version:

* Users who accepted the most recent major version do **not** need to re-accept
* Only users who did not accept the latest major version will be prompted
* Typically used for small text updates or non-critical clarifications

**Examples of changes suitable for a minor version:**

* Fixing typos
* Updating formatting
* Clarifying non-legal wording
* Adjusting minor details that do not affect user rights

Minor versions are labeled with decimals (e.g., **1.1**, **1.2**, **2.1**).

<Tip>
  Minor versions allow your team to keep the document up to date without requiring
  additional acceptance events for the entire user base.
</Tip>

## Choosing a version type

<Frame caption="Choosing between major and minor version">
  <img src="https://mintcdn.com/clickterm/Tkp_GRyJwpuLYp7_/product/images/version-type-selection.webp?fit=max&auto=format&n=Tkp_GRyJwpuLYp7_&q=85&s=c5dbe6a501f5048d5991c9d1c387fb82" alt="Choosing between major and minor version" width="886" height="1348" data-path="product/images/version-type-selection.webp" />
</Frame>

When adding a new version, you will be asked to choose between **Major** and **Minor**.

If you are unsure, choose a **major** version. This ensures that all users explicitly accept the latest content.

***

## Template version lifecycle

When you publish a new version, you must choose an **Effective at** date and time. That timestamp determines when the new version becomes visible to end users. Until the effective time is reached, the previously effective version continues to be presented.

<Frame caption="Publish dialog with version type selection and effective date picker">
  <img src="https://mintcdn.com/clickterm/Tkp_GRyJwpuLYp7_/product/images/version-effective-at.webp?fit=max&auto=format&n=Tkp_GRyJwpuLYp7_&q=85&s=b0855b9e08b756e79e9527ebccba29fc" alt="Publish dialog with version type selection and effective date picker" width="886" height="1348" data-path="product/images/version-effective-at.webp" />
</Frame>

By default, the current date and time are preselected, allowing the version to become effective immediately. Alternatively, you can schedule the version for the future.

<Note>
  If a **scheduled version** already exists, any new version can only go live at least
  **one hour after** the scheduled version's effective time. To go live sooner,
  delete the scheduled version first.
</Note>

<Info>
  Dates and times displayed in the ClickTerm UI are shown in your **browser's time zone**.
  When processed, they are automatically converted to **UTC**.
</Info>

### Lifecycle states

<Frame caption="Version lifecycle states">
  <img src="https://mintcdn.com/clickterm/Tkp_GRyJwpuLYp7_/product/images/version-lifecycle-states.webp?fit=max&auto=format&n=Tkp_GRyJwpuLYp7_&q=85&s=20b6103dad86a9b778abe68460b8bcf2" alt="Version lifecycle states" width="850" height="1144" data-path="product/images/version-lifecycle-states.webp" />
</Frame>

| State          | When it occurs                                            | End-user visibility                    |
| -------------- | --------------------------------------------------------- | -------------------------------------- |
| **Scheduled**  | Effective at is set in the future                         | Not visible to end users               |
| **Effective**  | Effective at time has been reached for the latest version | Visible to end users                   |
| **Superseded** | A newer version's effective at time has passed            | No longer shown; retained for auditing |

## Related

<CardGroup cols={2}>
  <Card title="Editing content" icon="pen-to-square" iconType="light" href="/product/templates/editing-content">
    Create and publish template versions.
  </Card>

  <Card title="Developer guide: Version lifecycle" icon="code" iconType="light" href="/dev/guides/version-lifecycle">
    How version lifecycle affects SDK behavior.
  </Card>
</CardGroup>
