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.
To create a snippet:
- Go to Library > Snippets.
- Click the + Create New Snippet button.
- Give your snippet a name. The Merge Code Name will auto-generate from the Snippet Name, but you can edit it if you'd like to.
- 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.
- 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.
- For code-based snippets, click the dropdown next to Snippet Content to select the Code Editor, and add your code there.
- Once you've finished formatting your snippet, click the Create button.
You can add snippets to:
- Individual articles
- 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.
There are a number of great use cases for snippets:
- Footer 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.