# Add remote files from Bitbucket Cloud

If your project files are stored in a remote repository on Bitbucket Cloud, you can connect that repository, so you can access and publish those files in Redocly.

To connect a Bitbucket Cloud repository, you must first create a new repository access token in Bitbucket Cloud.
Afterward, you must create a new branch, enter the connection details, and merge the open pull request in Reunite.

## Create a new repository access token in Bitbucket Cloud

Before entering the connection details in Reunite, you need to create and copy a new repository access token for your account in Bitbucket Cloud.
Redocly uses this access token to establish a connection to your repository.
The access token you use needs to have `repository:write`, `pullrequest:write` and `webhook` scopes.

See the Bitbucket Cloud documentation for creating the following access token types with appropriate permissions and scopes:

- [Create a repository access token](https://support.atlassian.com/bitbucket-cloud/docs/create-a-repository-access-token/)
- [Repository Access Token permissions](https://support.atlassian.com/bitbucket-cloud/docs/repository-access-token-permissions/)


## Create a new branch in Reunite

Before you make any changes to your project, create a new branch.
This new branch is a place where you can make changes without affecting the published site until you are ready.
After you have iterated on your changes based on reviews by your team and the updates have been approved, you can merge your changes into the published site.

To create a new branch:

1. From the Reunite editor, click the name of the current branch at the top of the page.

2. Enter the name for your new branch, for example `new-dev-branch`, and select **Create branch**.
Reunite automatically replaces spaces with hyphens `-`because spaces are not allowed in branch names.


## Enter the connection details in Reunite

After you have created a new branch in Reunite, you can add remote content to your project in Reunite using the connection details you have collected from Bitbucket Cloud.

To enter the connection details in Reunite:

1. In the file tree, select a folder (or click on the empty space to select the root directory) where you want to add the remote content.
2. Select **+ > New remote folder > Add Git repository** to add a remote content folder, or **+ > New remote file > Add Git repository** to add a remote content file.
3. Enter a name for the new remote content (folder or file) and press **Enter** or **Return** key.
4. From the list of Git providers, select **Bitbucket Cloud**.
5. Enter a **Credential name** for the new Bitbucket Cloud credential.
6. Enter the **Workspace name** of the Bitbucket Cloud Workspace and select **Next**
7. Enter the **Access token** you saved from the [Create a new repository access token in Bitbucket Cloud](#create-a-new-repository-access-token-in-bitbucket-cloud) step and select **Next**.
8. Select the **Namespace > Project > Branch**.
9. (Optional) Select the [**Folder**](/docs/realm/reunite/project/remote-content/remote-content#remote-contents-repository-folder) or [**File**](/docs/realm/reunite/project/remote-content/remote-content#remote-contents-repository-file), depending on whether you are adding a remote folder or a remote file.
10. (Optional) Select the [**Auto-sync**](/docs/realm/reunite/project/remote-content/remote-content#auto-sync-and-auto-merge) or [**Auto-merge**](/docs/realm/reunite/project/remote-content/remote-content#auto-sync-and-auto-merge) toggles to turn off either option.
11. Select **Add remote**.
This action opens a pull request in Reunite automatically.


You can click the **View Pull Request** button next to your new branch name to view the pull request.

## Merge the open pull request in Reunite

After you enter the connection details in Redocly, a pull request to merge your updates with the default branch opens.
When you merge the pull request your changes are added to your main branch and a production deploy is triggered.

To merge the open pull request in Reunite:

1. Select the **View Pull Request** button next to your branch name.
2. Review your updates in the **Review** tab.
3. After the tests have run and your pull request has been approved, click the **Merge** button to merge your updates with the default branch.


## Resources

- **[Connect a Git provider](/docs/realm/reunite/project/connect-git/connect-git-provider)** - Connect entire Bitbucket repositories to your project for comprehensive version control and automated documentation workflows
- **[Use the Editor](/docs/realm/reunite/project/use-editor)** - Leverage Reunite's collaborative editing tools for content creation with Bitbucket remote content integration and team collaboration features
- **[Projects overview](/docs/realm/reunite/project/projects)** - Manage feedback, deployment details, and project settings for Bitbucket remote content-enabled documentation projects
- **[Configuration reference](/docs/realm/config)** - Complete redocly.yaml configuration options for Bitbucket remote content integration and project customization