---
id: pystac-ext-version
version: "1.2.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-version — Version extension for PySTAC

License: permissive · Maintenance: active · Downloads: 4.0M/mo

## What it is and what it does

pystac-ext-version is a PySTAC extension package that implements the STAC Versioning Indicators Extension specification (v1.2.0). It provides a structured way to add version metadata to STAC items and collections, allowing you to track version numbers, deprecation status, and relationships between different versions of the same dataset or resource.

The package works as a plugin to pystac-core, adding schema validation and helper methods for working with version fields. It's designed for geospatial and imagery catalogs where datasets evolve over time and you need to maintain clear lineage between versions. The package version itself tracks the extension specification version it targets, with post-releases used for code updates that don't change the underlying extension version.

Use it for:

- Track version history of satellite imagery or raster datasets in a STAC catalog
- Mark deprecated STAC collections and provide links to their replacement versions
- Maintain predecessor/successor relationships for evolving geospatial datasets
- Validate version metadata fields in STAC items using the v1.2.0 extension schema

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds version tracking and deprecation status fields to PySTAC catalogs, enabling STAC items and collections to record version history and link to predecessor and successor versions.

Yes, if you're building or maintaining a PySTAC catalog that needs to track dataset versions or deprecation status. The package is actively maintained, has no security issues, installs with minimal friction, and is permissively licensed. Install it only if you actually need version tracking; it's a specialized extension, not a general-purpose tool.

## Install

pip install pystac-ext-version
uv add pystac-ext-version
poetry add pystac-ext-version

## Installing pystac-ext-version

Before you install: Low friction install with a single runtime dependency on pystac-core. Active maintenance with a recent release (4 days old) and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install pystac-ext-version

import pystac
from pystac.extensions.version import VersionExtension

# Use VersionExtension to add version fields to items/collections
item = pystac.Item(...)
VersionExtension.add_to(item)

Requires Python 3.10 or later; pystac-core must be installed as a runtime dependency.

Verify before relying:

- Whether the extension works with PySTAC versions other than the latest, or if pystac-core version pinning is strict
- Performance characteristics when handling large catalogs with complex version chains

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stac version extension, pystac versioning, track stac item versions, stac deprecation status, version indicators extension, pystac catalog versioning, geospatial, stac, metadata

[View on SkillFed](https://skillfed.io/packages/pystac-ext-version) · [View on PyPI](https://pypi.org/project/pystac-ext-version/)