Smart Snippets
A Smart Snippet is a block of HTML that CMSKite adds to your published posts when it serves them. You write it once. Your post text stays as you wrote it.
Create a snippet
Open Website settings → Snippets. You need permission to write content.
| Field | Notes |
|---|---|
| Name | Up to 80 characters |
| HTML | Up to 20,000 characters |
| Placement | Where in the post it goes. See below |
| Category, Author, Tag | Which posts get it. See below |
| Show in posts | A switch. Turn it off to stop showing the snippet without deleting it |
A website can have 50 snippets.
Placement
| Option | Result |
|---|---|
| At the start | Before the first line of the post |
| At the end | After the last line |
| Before heading N | Before the Nth H2 heading |
| After heading N | After the Nth H2 heading |
N is a number from 1 to 20. If the post has fewer H2 headings than N, the snippet goes at the end. Headings inside code fences do not count.
Which posts get it
Pick a category, an author, or tags. Each one can stay on Any. A post must match every one that you set. With all three on Any, every post gets the snippet.
With several tags, a post matches if it has any one of them. A snippet can have up to 50 targets.
Where it shows
- The snippet is added when CMSKite serves a published post to the hosted blog or to your website through a project key. It is never saved in the post.
- The editor shows the post as you wrote it.
- Plain-text posts never get snippets.
- The hosted blog removes scripts and event handlers from a snippet. A website that reads the API gets your HTML as written.
- CMSKite wraps the block in
<div class="cmskite-snippet" data-snippet="…">. Use that class to style it.
See also
To read posts from your own site, see Posts and Authentication.