--- title: "[Contentstack Launch] - Create a Project Using Bitbucket Cloud" description: Create a Project Using Bitbucket Cloud url: https://www.contentstack.com/docs/developers/launch/import-a-project-using-bitbucket-cloud product: Contentstack Launch doc_type: how-to audience: - developers version: unknown last_updated: 2026-06-16 --- # [Contentstack Launch] - Create a Project Using Bitbucket Cloud This page explains how to import and deploy a project in Contentstack Launch using Bitbucket Cloud as your Git repository host. It is intended for developers and organization admins/owners who need to connect Bitbucket Cloud to Launch and manage project setup, deployment, and troubleshooting. ## Create a Project Using Bitbucket Cloud Contentstack Launch streamlines your content delivery by connecting directly to your code repository. This guide provides step-by-step instructions for importing your project into Contentstack Launch using Bitbucket Cloud as your repository host. Unlike GitHub, which allows direct connections, Bitbucket Cloud requires installing a Marketplace app at the organizational level to establish the connection. ## Prerequisites - **Active Contentstack Launch Account**: Make sure you're ready to go with an active Launch account. - **Bitbucket Cloud Admin Access**: You'll need administrative control within your Bitbucket Cloud organization. - **Bitbucket Cloud Repository**: The project you want to import has to be on Bitbucket Cloud. - **OAuth Consumer Permissions**: Ensure you're allowed to install OAuth consumers in your Bitbucket Cloud organization. ## Install the Bitbucket Cloud Marketplace App Follow the steps given below to install the Bitbucket Cloud app from Contetnstack Marketplace - Log in to your [Contentstack](https://www.contentstack.com/login/) account and select the **Marketplace** icon from the dashboard. - Click **Apps** from the left panel. - Within the Marketplace, you can see the available apps. Hover over the **Bitbucket Cloud** app and click **Install**. - Authorize the app to let it integrate with your Bitbucket Cloud organization. - Grant the necessary permissions to allow Contentstack to access your Bitbucket Cloud repositories. ## Connect your Bitbucket Cloud Account to Launch **Note:** Only the Organization [Admin](/docs/developers/invite-users-and-assign-roles/types-of-roles/#admin)/[Owner](/docs/developers/invite-users-and-assign-roles/types-of-roles#owner) has the right to create projects in a stack for Launch. Now that the app is installed, let's follow the steps given below to establish a connection between your Bitbucket Cloud and Contentstack Launch. - Click the **Launch **option from the dashboard, as shown below. Alternatively, go to the **App Switcher** in the top panel and click the **Launch** icon. - Click **+ New Project**. - From the **Create New Project** modal, click **Import from a Git Repository**. - Select **Bitbucket Cloud** as your repository host. During this step, Contentstack Launch will request access to the repositories that you manage. ## Configure and Deploy your Project in Launch Now that we have connected your Bitbucket Cloud account with Contentstack Launch, we will now configure the project using the following steps: - Select the repository you want to import. - Then, define the following settings:**Environment Variables**: Add any required environment variables. - **Build Commands**: Specify the build and deployment commands for your project. - **Output Directory**: Define the folder for your built project (for example, `dist` or `build`).Select a response mode: **Streaming**: Delivers response chunks in real time as they are generated. - **Buffered**: Displays output only after the entire response has been generated. **Note:** Buffered is selected by default. **Additional Resource:** To fill out the **Create New Project** modal fields, refer to the sample data in your framework's [Quick Start Guide](/docs/developers/launch#launch-overview). - Once all the fields are filled with appropriate values and the configuration is complete, click the **Deploy **button. - Monitor the deployment logs to ensure the process completes successfully. ## Delete your Project from Launch To delete the project: - Select your project from the Launch dashboard. - Click the **Settings** icon. - In the **General** section, click the **Delete Project** button under **Delete Project**. - In the **Delete Project** modal, enter `DELETE` and click the **Yes, Delete** button.**Warning**: This action will remove all domains associated with this project. After the removal, your Contentstack domains will still be available for use. This deletes your project successfully. ## Troubleshooting Common Issues Below, we have listed some common issues you might encounter, along with their solutions. - **Connection Failure**:Ensure the Marketplace app is installed and active in your Bitbucket Cloud organization. - Verify that you have granted the necessary permissions during the app installation. - [Repair Bitbucket connection](/docs/developers/launch/repair-git-provider-connection-for-projects). - **Repository Not Found**:Confirm that the repository is hosted in the authenticated Bitbucket Cloud account. - Ensure you have Product admin access to access the repository. ## Common questions ### Who can create projects in Launch when using Bitbucket Cloud? Only the Organization Admin/Owner has the right to create projects in a stack for Launch. ### Why do I need to install a Marketplace app for Bitbucket Cloud? Bitbucket Cloud requires installing a Marketplace app at the organizational level to establish the connection. ### What should I do if Launch can’t connect to Bitbucket Cloud? Ensure the Marketplace app is installed and active, verify permissions granted during installation, and use the Repair Bitbucket connection link if needed. ### What happens when I delete a project in Launch? This action will remove all domains associated with this project. After the removal, your Contentstack domains will still be available for use. filename: contentstack-launch-create-a-project-using-bitbucket-cloud.md