Snippets help you share code segments or files with yourself, members of your workspace, or the world. One more way we're making code collaboration better for professional software teams.
- Are built for collaboration or individual sharing.
- Are syntax sensitive, making drag and drop quick and simple.
- Are 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 loosing context.
- Have amazing API support so you can build snippets into your app or process.
Snippets at a glance
Snippets are as simple as:
- Click + in the global sidebar and select Snippet under Create a new.
- Paste some code or drag a file onto the page.
Select the owner of the snippet from Create in menu.
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.
Set the permissions to either public or private.
Click Create snippet.
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.|
Clone your snippet so you can work on it locally and push back up to Bitbucket Cloud.
- Select Snippets from the left nav menu.
- Select the title of the 'snippet' you want to clone.
- Click the Clone button in the upper-right corner of the Snippets page.
Switch to the directory where you want to clone the snippet using the
cd(change directory) command as shown in the following example:
Paste the clone link into your terminal.
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 master before pushing changes. Trying to push a branch other than master will fail.