Snippets overview

Snippets help you share code segments or files with yourself, members of your workspace, or the world.

Snippets at a glance

  • Built for collaboration or individual sharing.

  • Syntax sensitive, making drag and drop quick and simple.

  • Built on Git so revisions are tracked and you can clone and push. 

  • Support multiple files, each snippet can have many files so you can share a single snippet without losing context.

  • Have amazing API support so you can build snippets into your app or process.

How to use snippets

  1. Select the Create button and select Snippet from the dropdown menu.

  2. Paste some code or drag a file onto the page.

  3. Select the owner of the snippet from Create in menu.

  4. Set the permissions to either public or private.

  5. Click Create snippet.

Once you save the snippet for the first time, you can no longer change which workspace owns the snippet.

Permissions in snippets

Here's how permissions work for snippets:

Snippet owner


Who can view

Who can edit



Anyone can view the snippet.

Any member of the workspace can edit the snippet.

To allow a new person to contribute to snippets you can add them to your workspace.


Only workspace members can view the snippet.

Cloning snippets

Clone your snippet so you can work on it locally and push back up to Bitbucket Cloud. 

  1. Select Snippets from the left nav menu.

  2. Select the title of the 'snippet' you want to clone. 

  3. Click the Clone button in the upper-right corner of the Snippets page.

  4. Switch to the directory where you want to clone the snippet using the cd (change directory) command as shown in the following example:

    1 cd path/to/directory
  5. Paste the clone link into your terminal.

  6. Start working on your snippet. 

You cannot push branches for your snippet. Once you've cloned the snippet to your local system you can use branching locally but must always merge into your main branch before pushing changes. Trying to push a branch other than your main branch will fail.

Still need help?

The Atlassian Community is here for you.