Skip to content

Using Integrations with the Deploy Button

Learn how to use Integrations with the Vercel Deploy Button.
Table of Contents
Choose a framework to optimize documentation to:
    Parameter
    Type
    Value
    integration-ids
    string[]
    A comma-separated list of required Integrations IDs: oac_4mkAfc68cuDV4suZRlgkn3R9, oac_JI9dt8xHo7UXmVV6mZTygMNZ

    This parameter allows you to specify a list of Integration IDs. When specified, the corresponding Integrations will be required to be added before the Project can be imported. You can add up to 3 Integrations per Project.

    You can find the IDs of your Integrations in the Integrations Console.

    Integrations which contain a "UI Hook URL" cannot be rendered in the Deploy Flow.

    The example below shows how to use the integration-ids parameter in a Deploy Button source URL:

    integration id
    https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&integration-ids=oac_1mkAfc68cuDV4suZRlgkn3Re
    Parameter
    Type
    Value
    skippable-integrations
    number
    Mark the list of provided Integrations as optional

    If this parameter is present, the user will be able to add one of the provided Integrations or skip them entirely, instead of being forced to add all of them.

    Because the user will only be able to select one (not multiple) of the optional Integrations, they should all serve the same purpose. For example, if the purpose is error tracking, the Integrations Sentry and Datadog could be defined here.

    To use this parameter, you also need to specify at least one Integration.

    The example below shows how to use the skippable-integrations parameter in a Deploy Button source URL:

    skippable integrations
    https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&integration-ids=oac_1mkAfc68cuDV4suZRlgkn3Re&skippable-integrations=1
    Last updated on September 29, 2023