Snippets

Snippets are chunks of reusable content and scripts. Learn how to create and use snippets.

What is a snippet?

Snippets are chunks of reusable content that can be placed within articles, categories, and even your theme's HTML. The content of the snippet can be as simple as a single word or sentence, or as complex as a JavaScript function that performs an action on whatever page it is used.

For example, you could create a snippet that contains your company's copyright information. Wherever you want the copyright to appear, instead of typing it out again and again, you would use the snippet's merge code in its place. 

When the page displays, the snippet merge code is replaced with the snippet's content. When you need to update your copyright information, you can edit and update the snippet content, and the changes will be automatically reflected wherever the snippet was used.

Creating a snippet

To create a snippet:

  1. Go to Library > Snippets.Screenshot showing the Library menu expanded, with a callout to the Snippets menu optionLibrary > Snippets menu option
  2. Click the  + Create New Snippet button.
    Screenshot showing the Snippet Library, with a callout to the Create New Snippet button under the Snippets titleCreate New Snippet button
  3. Give your snippet a name. This is how the name will appear in the Snippet Library and in snippet look-ups. The Merge Code Name will auto-generate from the Snippet Name, but you can edit it if you'd like to.
  4. Give your snippet a Description. This will help describe what your snippet does to other users (and may help remind you if you forget!) Here, we've added a name and description for a copyright statement. Screenshot showing the Edit Snippet screen, with callouts to the Snippet Name, Merge Code Name, and Snippet Description fieldsAdd a Snippet Name, Merge Code Name, and Snippet Description
  5. If your snippet is used to display text (as our copyright is), type and format the text you want to display directly in the WYSIWYG. Screenshot showing a sample Copyright Info snippet in the Edit Snippet screenSample completed snippet
  6. For code-based snippets, click the dropdown next to Snippet Content to select the Code Editor, and add your code there.
    Gif showing the Snippet Content selector being clicked to toggle between the Code Editor and WYSIWYG EditorToggle to the Code Editor
  7. Once you've finished formatting your snippet, click the Create button. Screenshot showing the full Copyright Info sample snippet with a callout to the Create button in the upper rightClick the Create button in the upper right

Your snippet will now display in the Snippet Library, as well as in the look-up field when someone tries to Insert Snippet into an article.

Using snippets

You can add snippets to:

  • Individual articles
  • Categories
  • Custom HTML (adding snippets to Custom HTML > Body is great for adding footer content; you can add snippets to Custom HTML > Article to add them to all articles)

To add a snippet, you will need to add its Merge Code Value--this is a value in double curly brackets, with snippet.MergeCodeName after it. For individual articles, you can use the Add Snippet button to add a snippet: 

This will open a pop-up where you can search for your snippet. Type the name and click on the suggestion that matches it. This will display the Description and Snippet body so you can be sure you've selected the correct snippet. Once you're sure you've selected the correct snippet, click Insert Snippet.

You should now see your merge code value in the article, like this:

Anyone viewing the knowledge base will see the body of the snippet (if it's text) or will see the results of the code in it. For example:

Copyright © 2015 – 2019 Silly Moose, LLC. All rights reserved.

These documents are a static export of a dynamic knowledge base. For the most up-to-date information, please see our knowledge base.

Snippet Library

All created snippets are stored in the Snippet Library. To access this library, go to Library > Snippets.

Within the Snippet Library, you can:

  1. Create new snippets
  2. Search for existing snippets using words in the snippet title and description
  3. Click on any snippet to open it in edit mode
  4. Delete a snippet by clicking the X in the upper right corner

Note: The Snippet Library is sorted alphabetically and is case sensitive. This means that all snippets beginning with upper case letters will appear first, in alphabetical order, followed by all snippets beginning with lower case letters, also in alphabetical order.

Snippet use cases

There are a number of great use cases for snippets:

  • Footers or other statements that need to be used a lot of places, such as confidentiality statements
  • Brand names or terms that may change frequently: make a snippet for that term, only reference the snippet instead of the full term in all your documentation. When the term needs updating, update only the snippet and all your documentation is updated!
  • Specialized sections for articles, such as Article Table of Contents
  • Code to handle unusual formatting, or to provide a set of styles for individual articles that differs from your general knowledge base styles.