Post widgets and category blogs
The [embed](/docs/embed) can also show a short list of posts on any page, such as a sidebar or your home page. It can limit the blog list to one category.
Show one category
Add data-category with the category’s slug to the embed script. The list shows only the posts of that category.
One category
<div id="cmskite-blog"></div>
<script src="https://cmskite.com/embed.js" data-blog="YOUR-HANDLE" data-category="news" async></script>Recent posts
Add data-widget="recent" to show the newest posts as cards. Each card links to the post. It does not open posts or take over the page.
Three newest posts
<div id="cmskite-widget"></div>
<script src="https://cmskite.com/embed.js" data-blog="YOUR-HANDLE" data-widget="recent" data-limit="3" async></script>Add data-category to show recent posts from one category only.
Picked posts
Add data-widget="posts" and data-posts with post slugs, separated by commas. The widget shows them in that order. It shows up to 12 posts.
Two chosen posts
<div id="cmskite-widget"></div>
<script src="https://cmskite.com/embed.js" data-blog="YOUR-HANDLE" data-widget="posts" data-posts="first-post,second-post" async></script>Attributes
| Attribute | Meaning |
|---|---|
data-category | A category slug. Limits the list, or the recent posts widget, to that category |
data-widget | recent or posts |
data-limit | How many recent posts: 1 to 50. The default is 3 |
data-posts | Post slugs, separated by commas, in display order |
data-target | The id of the element to draw in. A widget uses cmskite-widget when you do not set it |
data-accent | A colour for links and labels |
data-lang | en, pt-BR or es. The language of the words around the posts. The default is your blog’s language |
Where the cards link
A card links to the post on your own site once CMSKite knows your blog page. Until then it links to the hosted blog. See Hosted blog.