---
id: pystac-ext-item-assets
version: "1.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-item-assets — Item Assets extension for PySTAC

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

## What it is and what it does

This package is a PySTAC extension that implements the Item Assets Definition Extension specification (v1.0.0). It allows STAC collections to declare common asset properties—such as media type, title, or description—that apply across all items in the collection, rather than repeating those properties on every individual item. This reduces redundancy and provides a clear template for what assets consumers should expect to find.

You use it by importing the extension and applying it to a PySTAC collection object. The extension is lightweight, depending only on pystac-core, and is maintained actively. It targets modern Python versions (3.10+) and carries no known security issues.

Use it for:

- Define asset schemas for satellite imagery collections where all items share the same band structure and metadata.
- Standardize asset properties across a large catalog to reduce duplication and improve consistency.
- Publish STAC collections that conform to the Item Assets Definition Extension specification.
- Template asset definitions for multi-item collections with predictable asset structures.

## Worth the install?

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

Extends PySTAC to support the Item Assets Definition Extension, enabling collections to define shared asset properties as templates across all items.

Yes, if you are building or consuming STAC collections and need to declare shared asset properties across items. The extension is actively maintained, has no known vulnerabilities, and integrates cleanly with PySTAC. Install it only if your use case requires the Item Assets Definition Extension; base PySTAC may be sufficient for simpler catalogs.

## Install

pip install pystac-ext-item-assets
uv add pystac-ext-item-assets
poetry add pystac-ext-item-assets

## Installing pystac-ext-item-assets

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

License in practice: Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions—suitable for most commercial and open-source projects.

Quickstart:

pip install pystac-ext-item-assets

from pystac_ext_item_assets import ItemAssetsExtension

# Use with a PySTAC collection to define shared asset properties
extension = ItemAssetsExtension.from_collection(collection)

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

Verify before relying:

- Whether this extension is required for your use case or if base PySTAC handles your asset-definition needs.
- Compatibility with specific versions of pystac-core beyond the dependency declaration.

## 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

pystac item assets extension, stac collection asset templates, pystac asset definition, stac item assets schema, pystac extension library, catalog asset properties, stac, geospatial, catalog-metadata

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