Deploy Button Source
Learn how to use the Vercel Deploy Button source URL parameters.| Parameter | Type | Value |
|---|---|---|
repository-url | string | The source Git repository URL |
The Repository URL parameter allows you to define a Git repository URL, optionally including the subdirectory within a repository, that users will clone into their GitHub, GitLab, or Bitbucket account when going through the Vercel Project creation flow.
The example below shows how to use the Repository URL parameter to set the repository URL to hello-world:
https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-worldThe Repository URL parameter is required when sending a user to the Vercel Project creation flow to set up a project from a GitHub, GitLab, or Bitbucket repository.
| Parameter | Type | Value |
|---|---|---|
project-name | string | A default project name |
The Project Name parameter allows you to define a default project name.
This parameter is useful for cases where already know what the user would like to name their project. For example, if you are sending the user to the Project creation flow from an application that has already set up a project for the user that will connect to the created Vercel project.
If there is an existing project using the name passed with this parameter, the user will be required to define a new project name, and therefore the project is not guaranteed to have the specified name.
The example below shows how to use the Project Name parameter to set the project name to "my-awesome-project":
https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&project-name=my-awesome-project| Parameter | Type | Value |
|---|---|---|
repository-name | string | A default repository name (no spaces) |
The Repository Name parameter allows you to define a default repository name.
Similar to the Project Name parameter, this parameter is useful in cases where you already know what the user wants to name their repository.
The example below shows how to use the Repository Name parameter to set the repository name to "my-awesome-project":
https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&repository-name=my-awesome-projectWas this helpful?