---
title: 'Announcement: Pydantic V2 Release'
description: Official release note for Pydantic V2 - with migration guide
date: '2023-06-30'
authors:
  - Samuel Colvin
  - Terrence Dorsey
categories:
  - Pydantic Validation
canonical: 'https://pydantic.dev/articles/pydantic-v2-final'
---

> Markdown version of [Announcement: Pydantic V2 Release](https://pydantic.dev/articles/pydantic-v2-final) — the canonical HTML page.
>
> By [Samuel Colvin](https://pydantic.dev/authors/samuel-colvin.md), Terrence Dorsey · 2023-06-30 · Pydantic Validation
>
> Related: [Emscripten wheels for Pydantic](https://pydantic.dev/articles/emscripten-wheels-pydantic.md) · [Announcement: Pydantic v2.13 Release](https://pydantic.dev/articles/pydantic-v2-13-release.md)
>
> All articles: [/articles.md](https://pydantic.dev/articles.md) · Site index: [/llms.txt](https://pydantic.dev/llms.txt)

---

The last few months have involved a whirlwind of work, and we're finally ready to announce to official release of
Pydantic V2!

## Getting started with Pydantic V2

To get started with Pydantic V2, install it from PyPI:

```bash
pip install -U pydantic
```

Pydantic V2 is compatible with Python 3.8 and above.

See [the docs](https://pydantic.dev/docs/validation/latest/get-started/) for examples of Pydantic at work.

<!-- more -->

## Migration guide

If you are upgrading an existing project, you can use our extensive [migration guide](https://pydantic.dev/docs/validation/latest/get-started/migration/) to understand
what has changed.

If you do encounter any issues, please [create an issue in GitHub](https://github.com/pydantic/pydantic/issues/new?assignees=&labels=bug+V2%2Cunconfirmed&projects=&template=bug-v2.yml)
using the `bug V2` label.
This will help us to actively monitor and track errors, and to continue to improve the library’s performance.

Thank you for your support, and we look forward to your feedback.