LogoAI Jet
icon of semantic-release

semantic-release

Automates package release workflow: version management, release notes generation, and package publishing based on commit messages.

Introduction

semantic-release

semantic-release automates the entire package release workflow, determining version numbers, generating release notes, and publishing packages based on commit messages. It enforces Semantic Versioning, ensuring changes are communicated effectively to users.

Key Features:

  • Fully Automated Release: Eliminates manual intervention in the release process.
  • Semantic Versioning: Enforces strict adherence to Semantic Versioning.
  • Continuous Delivery: New features and fixes are immediately available.
  • Automated Notifications: Notifies maintainers and users of new releases.
  • Commit Message Convention: Uses formalized commit messages to document changes.
  • Distribution Channels: Publishes to different distribution channels based on Git merges.
  • CI Integration: Integrates with continuous integration workflows.
  • Error Reduction: Avoids potential errors associated with manual releases.
  • Extensible via Plugins: Supports various package managers and languages.
  • Shareable Configurations: Simple and reusable configurations.
  • npm Package Provenance: Supports increased supply-chain security via signed attestations on GitHub Actions.

Use Cases:

  • Automating releases for npm packages.
  • Managing versioning for software libraries.
  • Ensuring consistent release processes across multiple projects.
  • Integrating with CI/CD pipelines for continuous delivery.
  • Enforcing commit message conventions for better documentation.

Latest News

-

-

8/5/2026

> For the complete documentation index, see [llms.txt](https://semantic-release.gitbook.io/semantic-release/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://semantic-release.gitbook.io/semantic-release/nex...

-

-

8/5/2026

> For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as Markdown. # Configuration semantic-release configuration consists of: - Git repository (URL and options release branches and tag ...

-

-

8/5/2026

> For the complete documentation index, see [llms.txt](https://semantic-release.gitbook.io/semantic-release/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://semantic-release.gitbook.io/semantic-release/bet...

-

-

8/5/2026

> For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as Markdown. # Frequently Asked Questions ## Why is the `package.json`’s version not updated in my repository? semantic-release take...

-

-

8/5/2026

> For the complete documentation index, see [llms.txt](https://semantic-release.gitbook.io/semantic-release/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://semantic-release.gitbook.io/semantic-release/nex...

Alternatives

  • Release Please

    Automates versioning and changelog generation based on conventional commits, similar to semantic-release.

  • Lerna

    A monorepo manager that handles versioning and publishing for multiple packages within a single repository.

  • Changesets

    Provides a structured workflow for managing versioning and changelogs, especially useful for monorepos and explicit change tracking.

  • Standard Version

    A command-line tool that automates version bumping and changelog generation using conventional commits.

  • GitHub Actions (custom workflow)

    Allows users to build highly customized release pipelines using a flexible CI/CD platform and scripting.

  • GoReleaser

    A comprehensive release automation tool specifically designed for Go projects, handling binaries, checksums, and publishing.

  • Conventional Changelog CLI

    Focuses on generating changelogs and determining the next version based on conventional commit messages.

  • GitVersion

    Automatically generates semantic version numbers from your Git history, providing a robust versioning strategy.

  • Jenkins (with pipeline scripts)

    A powerful automation server that can be configured with custom scripts and plugins to manage complex release workflows.

  • NPM/Yarn scripts (manual automation)

    Offers a basic, script-driven approach to automate versioning and publishing using built-in package manager commands.

FAQ

More Products

Deploy anywhere from your AI tool.

AI-powered product management platform with contextual intelligence that helps product managers, agencies, and software houses generate requirements, manage UI

A unified performance testing orchestration platform that connects control, visibility, and intelligence into a single performance system for distributed load t

A product documentation and knowledge management tool for teams, shutting down August 31, 2026. Delibr helped teams organize product work through collections an

Open-source platform for training and running AI models locally with 2x faster fine-tuning, 90% less memory usage, and support for 500+ models on Mac and Window

A prompt management platform for product teams to build, test, and deploy AI prompts collaboratively with built-in security features.

AI prompt management platform with version tracking, testing, and team collaboration. One API key to access all major AI models including GPT-5, Claude, and Gem

A platform for designing, testing, and deploying LLM prompts with automatic testing, evaluation, and team collaboration features.

AI Prompt Management System with version control, testing suite, and CI/CD pipeline for LLM prompts. Enables team collaboration and real-time API deployment.

Open-source LLMOps platform for prompt management, evaluation, and observability to help teams build reliable LLM applications.

Cloud platform providing access to state-of-the-art machine learning models and inference infrastructure for developers and businesses.

AI coding tool with advanced context management that helps developers craft optimized prompts for complex coding tasks on existing codebases.

The Intelligent Knowledge Platform helping teams create and maintain world-class documentation built for both humans and AI.

Enterprise AI platform offering the H2O AI Super Agent™ for Sovereign AI, enabling organizations to build and deploy AI solutions with data sovereignty and secu

Production stack for GenAI builders providing AI Gateway, Observability, Guardrails, Governance, and Prompt Management in one unified platform.

Unified AI governance platform for building, managing, and enforcing guardrails and policies across enterprise AI interactions with runtime protection and compl