Deep-dive on the Next Gen Platform. Join the Webinar!

Skip Navigation
Show nav
Dev Center
  • Get Started
  • Documentation
  • Changelog
  • Search
  • Get Started
    • Node.js
    • Ruby on Rails
    • Ruby
    • Python
    • Java
    • PHP
    • Go
    • Scala
    • Clojure
    • .NET
  • Documentation
  • Changelog
  • More
    Additional Resources
    • Home
    • Elements
    • Products
    • Pricing
    • Careers
    • Help
    • Status
    • Events
    • Podcasts
    • Compliance Center
    Heroku Blog

    Heroku Blog

    Find out what's new with Heroku on our blog.

    Visit Blog
  • Log inorSign up
Hide categories

Categories

  • Heroku Architecture
    • Compute (Dynos)
      • Dyno Management
      • Dyno Concepts
      • Dyno Behavior
      • Dyno Reference
      • Dyno Troubleshooting
    • Stacks (operating system images)
    • Networking & DNS
    • Platform Policies
    • Platform Principles
  • Developer Tools
    • Command Line
    • Heroku VS Code Extension
  • Deployment
    • Deploying with Git
    • Deploying with Docker
    • Deployment Integrations
  • Continuous Delivery & Integration (Heroku Flow)
    • Continuous Integration
  • Language Support
    • Node.js
      • Working with Node.js
      • Node.js Behavior in Heroku
      • Troubleshooting Node.js Apps
    • Ruby
      • Rails Support
      • Working with Bundler
      • Working with Ruby
      • Ruby Behavior in Heroku
      • Troubleshooting Ruby Apps
    • Python
      • Working with Python
      • Background Jobs in Python
      • Python Behavior in Heroku
      • Working with Django
    • Java
      • Java Behavior in Heroku
      • Working with Java
      • Working with Maven
      • Working with Spring Boot
      • Troubleshooting Java Apps
    • PHP
      • PHP Behavior in Heroku
      • Working with PHP
    • Go
      • Go Dependency Management
    • Scala
    • Clojure
    • .NET
      • Working with .NET
  • Databases & Data Management
    • Heroku Postgres
      • Postgres Basics
      • Postgres Getting Started
      • Postgres Performance
      • Postgres Data Transfer & Preservation
      • Postgres Availability
      • Postgres Special Topics
      • Migrating to Heroku Postgres
    • Heroku Key-Value Store
    • Apache Kafka on Heroku
    • Other Data Stores
  • AI
    • Working with AI
  • Monitoring & Metrics
    • Logging
  • App Performance
  • Add-ons
    • All Add-ons
  • Collaboration
  • Security
    • App Security
    • Identities & Authentication
      • Single Sign-on (SSO)
    • Private Spaces
      • Infrastructure Networking
    • Compliance
  • Heroku Enterprise
    • Enterprise Accounts
    • Enterprise Teams
    • Heroku Connect (Salesforce sync)
      • Heroku Connect Administration
      • Heroku Connect Reference
      • Heroku Connect Troubleshooting
  • Patterns & Best Practices
  • Extending Heroku
    • Platform API
    • App Webhooks
    • Heroku Labs
    • Building Add-ons
      • Add-on Development Tasks
      • Add-on APIs
      • Add-on Guidelines & Requirements
    • Building CLI Plugins
    • Developing Buildpacks
    • Dev Center
  • Accounts & Billing
  • Troubleshooting & Support
  • Integrating with Salesforce
  • Extending Heroku
  • Building Add-ons
  • Add-on Development Tasks
  • Add-on Manifest

Add-on Manifest

English — 日本語に切り替える

Last updated March 20, 2025

Table of Contents

  • Requirements
  • Generating a Manifest
  • Updating a Manifest
  • Example Manifest
  • Fields

The add-on manifest is a JSON document which describes the interface between Heroku and your cloud service. You write the manifest and manage it with the addons-admin CLI plugin in your development environment, then send the final manifest to Heroku when you’re ready to submit your add-on to our marketplace.

Requirements

  • A Heroku account
  • A working installation of the Heroku CLI
  • The addons-admin CLI plugin

Generating a Manifest

First, make sure you have the latest version of the addons-admin plugin:

$ heroku plugins:install addons-admin

Generate a new manifest:

$ heroku addons:admin:manifest:generate
# an interactive prompt will run, asking you basic questions about your new add-on

A manifest contains secrets. Don’t check it into source control.

Updating a Manifest

First, pull your manifest locally:

$ heroku addons:admin:manifest:pull your-add-on-id-here

Your add-on’s ID, also known as slug, saves to the file addon-manifest.json in your current working directory.

After making the necessary changes, publish them with push:

$ heroku addons:admin:manifest:push

This command pushes the contents of addon-manifest.json to the add-on identified by the id attribute in that file.

Example Manifest

{
  "id": "errorbucket",
  "name": "Errorbucket",
  "cli_plugin_name": "heroku-errorbucket",
  "api": {
    "config_vars_prefix": "ERRORBUCKET",
    "config_vars": [
      "ERRORBUCKET_URL"
    ],
    "password": "GqAGAmdrnkDFcvR9",
    "sso_salt": "7CwqmJLEjv8YZTXK",
    "regions": ["us","eu"],
    "requires": ["log_input"],
    "production": {
      "base_url": "https://errorbucket.com/heroku/resources",
      "sso_url": "https://errorbucket.com/sso/login"
    },
    "version": "3"
  }
}

Fields

id

An id for your add-on. This value is what users enter when they type “heroku addons:create [your-add-on]” It’s also used for HTTP basic auth when making provisioning calls. It must be in all lowercase, no spaces or punctuation. You can’t change it after the first push to Heroku.

name

The name of your add-on.

cli_plugin_name

The npm package name of your add-on service’s Heroku CLI plugin.

api/config_vars_prefix

Optional and defaults to a normalized version of your add-on slug/ID. For example, fast-db has a prefix of FAST_DB. Config vars in your manifest and in response to provision requests must begin with this prefix, followed by a single _, then any valid identifier.

api/config_vars

A list of config vars that returns on provisioning calls. Typically, you have exactly one, the resource URL, but multiple config vars are supported when a single config var doesn’t suffice.

api/password

A password that Heroku sends in HTTP basic auth when making provisioning calls.

api/sso_salt

Shared secret used in single sign-on between the Heroku admin panel and your service’s admin panel.

api/regions

The list of geographical regions supported by your add-on. It can’t be empty. Valid Common Runtime regions are:

  • us
  • eu

Valid Private Spaces Runtime regions are:

  • dublin
  • frankfurt
  • london
  • montreal
  • mumbai
  • oregon
  • singapore
  • sydney
  • tokyo
  • virginia

Add-ons must currently support at least the Common Runtime US region. Support for EU and Private Spaces Runtime, of either the Cedar or Fir generation, is optional. If your add-on is region-agnostic, for example, not latency sensitive, and behavior doesn’t differ from region-to-region, use the meta-region * to signify full support for any current or future region.

api/requires

A list of features you want to enable. The currently public list of features that you can enable are:

  • log_input - Adds the log_input_url field to provision requests, which you can use to write your own messages to the log.
  • syslog_drain - Adds the log_drain_token field to provision requests. If you respond with a log drain URL, you can use this token to identify logs coming from the application. See this article for more details.
  • many_per_app - Allows developers to provision or attach multiple installations of your add-on. With this feature enabled, customers can also give attachments to the add-ons custom names.
  • attachable - Allows developers to share an add-on between multiple apps. If many_per_app is also enabled, it allows them to give the same add-on multiple aliases (attachments) to one app.

log_input and syslog_drain are unavailable when the add-on is provisioned to a Fir-generation app. See Add-ons Generation Compatibility Guide for Partners for details.

api/version

The version of the Partner API, the HTTP interface Heroku uses to communicate with your add-on service. If you don’t specify a value, the manifest assumes the current version of the partner API 3. It’s advisable to explicitly set this in your manifest.

api/production/base_url

The production endpoint for Heroku API actions, such as provision, deprovision, or plan change. The path /heroku/resources must always be at the end of this URL, and automatically appends on the server side if it’s missing. You must use HTTPS.

api/production/sso_url

The production endpoint for single sign-on. You must use HTTPS.

Keep reading

  • Add-on Development Tasks

Feedback

Log in to submit feedback.

Writing to Application Logs as an Add-on Partner Add-on Single Sign-on

Information & Support

  • Getting Started
  • Documentation
  • Changelog
  • Compliance Center
  • Training & Education
  • Blog
  • Support Channels
  • Status

Language Reference

  • Node.js
  • Ruby
  • Java
  • PHP
  • Python
  • Go
  • Scala
  • Clojure
  • .NET

Other Resources

  • Careers
  • Elements
  • Products
  • Pricing
  • RSS
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku Blog
    • Heroku News Blog
    • Heroku Engineering Blog
  • Twitter
    • Dev Center Articles
    • Dev Center Changelog
    • Heroku
    • Heroku Status
  • Github
  • LinkedIn
  • © 2025 Salesforce, Inc. All rights reserved. Various trademarks held by their respective owners. Salesforce Tower, 415 Mission Street, 3rd Floor, San Francisco, CA 94105, United States
  • heroku.com
  • Legal
  • Terms of Service
  • Privacy Information
  • Responsible Disclosure
  • Trust
  • Contact
  • Cookie Preferences
  • Your Privacy Choices