---
id: zope-configuration
version: "7.1"
license: ZPL-2.1
license_treatment: unclear
maintenance: active
---

# zope.configuration — Zope Configuration Markup Language (ZCML)

License: unclear · Maintenance: active · Downloads: 862.2K/mo

## What it is and what it does

Zope.configuration is a framework for building extensible configuration systems centered on configuration directives. It abstracts the idea that users express configuration choices in a pluggable language—XML by default—which the system then interprets and applies. The package is part of the Zope ecosystem and provides the core machinery for declarative configuration, allowing applications to define what configuration directives are valid, how they are processed, and what actions they trigger.

The package depends on zope.interface, zope.schema, and zope.i18nmessageid to handle interface definitions, field validation, and internationalization of messages. It is typically used in frameworks or applications that need to support configuration files written in a domain-specific language rather than Python code, enabling non-developers to adjust application behavior through configuration markup.

Use it for:

- Build a web framework that accepts XML-based configuration files to define routes, handlers, and middleware without requiring code changes.
- Create a plugin system where third-party packages register configuration directives that are validated and executed at startup.
- Implement a declarative configuration layer for a CMS or application server where administrators configure features via ZCML markup.
- Support environment-variable-based conditional configuration (added in version 6.0) to enable different setups for dev, test, and production.
- Extend an existing Zope-based application with custom configuration directives for domain-specific settings.

## Worth the install?

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

Zope.configuration provides an extensible configuration system based on configuration directives, with XML as the default language, enabling pluggable configuration approaches for applications.

Yes, if you are building or extending a Zope-based application or need a mature, extensible configuration framework with XML support. The package is actively maintained, has no known vulnerabilities, and supports modern Python versions. Verify ZPL-2.1 license compatibility first. Not necessary for most general-purpose Python applications.

## Install

pip install zope-configuration
uv add zope-configuration
poetry add zope-configuration

## Installing zope.configuration

Before you install: Low install friction with three lightweight runtime dependencies. Actively maintained as of 2026-04-10, supporting modern Python versions (3.10 through 3.14) and PyPy. No known vulnerabilities.

License in practice: Licensed under ZPL-2.1 (Zope Public License 2.1), though license treatment is marked unclear in the metadata. Verify compatibility with your project's license requirements before use.

Quickstart:

pip install zope.configuration

from zope.configuration import xmlconfig
xmlconfig.file('configure.zcml')

Requires Python 3.10 or later.

Verify before relying:

- Whether ZPL-2.1 is compatible with your project's license or distribution model.
- Whether the XML-based configuration language meets your use case or if custom directive languages are needed.

## Package facts

- License: ZPL-2.1 (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 862.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

configuration management system, zcml xml configuration, zope configuration directives, extensible config framework, declarative configuration language, zope-ecosystem, declarative-config, xml-markup

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