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

# Prompt Versions

> As teams build their AI applications, a big part of experimentation is iterating on the prompt structure. In order to collaborate effectively and organize your changes clearly, Maxim allows prompt versioning and comparison runs across versions.

export const MaximPlayer = ({url}) => {
  return <iframe className="border-background-highlight-secondary h-full w-full rounded-md border-2 aspect-video" src={url} allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe>;
};

<MaximPlayer url="https://www.youtube.com/embed/ms-0zXuo0ks?si=ElCplIL7RT7AybX_" />

## Create prompt versions

A prompt version is a set of messages and configurations that is published to mark a particular state of the prompt. Versions are used to run tests, compare results and make deployments.

<Steps>
  <Step title="Identify unpublished changes">
    If a prompt has changes that are not published, a badge showing `unpublished changes` will show near its name in the header.

    <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/create-versions/unpublished-changes.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=ad66dfeb6781ed1b487217cc09fe202f" alt="Unpublished changes" width="772" height="78" data-path="images/docs/evaluate/how-to/evaluate-prompts/create-versions/unpublished-changes.png" />
  </Step>

  <Step title="Publish a new version">
    To publish a version, click on the `publish version` button in the header and select which messages you want to add to this version. Optionally add a description for easy reference of other team members.

    <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/create-versions/publish-version.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=de11a459b56c244162262fc995a02dc4" alt="Publish version" width="804" height="1072" data-path="images/docs/evaluate/how-to/evaluate-prompts/create-versions/publish-version.png" />
  </Step>

  <Step title="Access version history">
    View recent versions by clicking on the arrow adjoining the `publish version` button and view the complete list using the button at the bottom of this list. Each version includes details about publisher and date of publishing for easy reference. Open any version by clicking on it.

    <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/create-versions/version-list.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=db280e777fb424830582b704fad3d8e6" alt="Version list" width="686" height="1100" data-path="images/docs/evaluate/how-to/evaluate-prompts/create-versions/version-list.png" />
  </Step>
</Steps>

## Compare prompt versions

Track changes between different prompt versions to understand what led to improvements or drops in quality.

<Steps>
  <Step title="Access Prompt versions">
    Open the Prompt you want to analyze

    Click "View all versions" from the versions dropdown

    <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/versions-list-dropdown.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=f548bcaf1eb6fc956662890591262618" alt="List of all Prompt versions" width="2048" height="1236" data-path="images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/versions-list-dropdown.png" />
  </Step>

  <Step title="Enter comparison mode">
    Select "Comparison view" from the versions list

    <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/versions-list-sheet.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=6952c13aaa7b81879765843aa077eb15" alt="Comparison view button in versions list" width="2890" height="1804" data-path="images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/versions-list-sheet.png" />
  </Step>

  <Step title="Choose versions to compare">
    Select two versions to compare:

    * First version is auto-selected
    * Pick a second version to compare against
    * Click "Compare versions" to proceed
    * Change selection anytime during comparison

          <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/select-versions-to-compare.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=85d7b7b8bd898d540afde822319af6ab" alt="Version selection interface" width="2890" height="1730" data-path="images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/select-versions-to-compare.png" />
  </Step>

  <Step title="Review differences">
    See changes between versions in a diff view that highlights:

    * Configuration changes
    * Message content updates
    * Parameter modifications

    **Pro tips:**

    * Switch version order using the swap button
    * Navigate between changes using the counter in header
    * Share comparison URL with team members

          <img src="https://mintcdn.com/maximai/ZQA_95CgxXFSFido/images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/prompt-version-compare-quick-tips.png?fit=max&auto=format&n=ZQA_95CgxXFSFido&q=85&s=14ad4896440a04108835f76a3c0502f7" alt="Comparison interface with highlighted features" width="2048" height="1226" data-path="images/docs/evaluate/how-to/evaluate-prompts/compare-prompt-versions/prompt-version-compare-quick-tips.png" />
  </Step>
</Steps>

## Next steps

* [Run experiments on prompt versions](/offline-evals/via-ui/prompts/prompt-evals)
* [Deploy prompt versions](/prompt-engineering/prompt-deployment)