Tags

Short words or phrases used to group snippets.

Tags are short words or phrases that you can use to label and retrieve a group of snippets. You can tag snippets by domain, product, project, or anything else you’d like. To keep tags short and easy to remember, only lowercase letters, numbers, and hyphens are allowed.

Tags are especially useful when combined with our SDKs or API to render a group of snippets with a single network request. Reducing the number of requests your application makes to our API for content improves your application’s response time.

Viewing tags

  1. Sign in to your account.
  2. Click the Tags link in the navigation on the left.

We’ll call this your “tags dashboard”, and the rest of this article will assume you’re starting here.

Generally, it’s a good idea to periodically curate your organization’s collection of tags. Over time, similar-but-misspelled tags can accumulate, and unused or disused tags make it more difficult for your team to find the correct tag when searching.

Creating tags

You can create a tag two ways: you can create a tag by itself, or you can create a tag by tagging a snippet.

To create a tag by itself:

  1. Visit your tags dashboard.
  2. Click the New tag button in the top-right of the page.
  3. Fill in the tag’s text.
  4. Click the Save tag button.

To create a tag by tagging a snippet:

  1. Sign in to your account.
  2. Open a snippet.
  3. Click the Tags link beneath the snippet’s name.
  4. Fill in the tag’s text.
  5. Click the Add tag button.

Updating tags

To update a tag:

  1. Visit your tags dashboard.
  2. Find the tag you’d like to update.
  3. Click the tag’s name link.
  4. Fill in the tag’s new text.
  5. Click the Save tag button.

Be careful updating a tag’s text. If your application is using a tag to select a group of snippets, changing the tag’s text will break the integration. Your code will no longer point to a tag in our system, and an exception will likely be raised.

Deleting tags

To delete a tag:

  1. Visit your tags dashboard.
  2. Find the tag you’d like to update.
  3. Click the ellipsis () at the end of the tag’s row.
  4. Click the Delete link.
  5. Click the confirmation’s Ok button.

Be careful deleting a tag. If your application is using a tag to select a group of snippets, deleting the tag will break the integration. Your code will no longer point to a tag in our system, and an exception will likely be raised.