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 or user owns the snippet.

If you want to let others contribute to a snippet you'll need to transfer the snippet to your organization's workspace. 

Permissions in snippets

Here's how permissions work for snippets:

Snippet owner

Setting

Who can view

Who can edit

Workspace

Public

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.

Private

Only workspace members can view the snippet.

Individual account

Public

Anyone can view the snippet.

Only the owner of an individual snippet can edit the snippet.

Private

Only you 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.

Additional Help