Blogs

Publish posts and embed your blog on any site.

Write and publish posts in the dashboard, then embed the reading experience anywhere with one script tag. The embedded blog lists your published posts as cards and opens each one in place - with its table of contents, share buttons, comments, subscribe box and related posts. You control all of that from the SoftSolz dashboard; the website reflects your changes automatically, no redeploy needed.

Embed your blog in 3 steps

1. Create a brand-new, blank page on your site at any path you like, for example /blog. It must be empty - your posts render into it.
2. Add a container where the blog should appear:
   Step 2 - container div

   <div id="softsolz-blog"></div>

3. Add the loader script directly under that div, then publish the page:
   Step 3 - script tag

   <script src="https://app.softsolz.uk/softsolz.js"
     data-public-key="pk_live_your_key"
     data-service-id="blogs"
     data-mount="#softsolz-blog"></script>

On a dark-background site, add data-theme="dark" to the script so the blog text stays readable.

Reader analytics

Add data-analytics="on" to the script tag to report post views, the referring site and the campaign tag on the incoming link. Results appear under Blogs -> Analytics -> Readers. This level stores nothing on the reader's device and does not follow anyone between visits, so it needs no cookie banner. It must also be enabled for the workspace under Blogs -> Settings -> Privacy.

<script src="https://app.softsolz.uk/softsolz.js"
  data-public-key="pk_live_your_key"
  data-service-id="blogs"
  data-mount="#softsolz-blog"
  data-analytics="on"></script>

To link a reader's visits together - and see what someone read before they subscribed - call Softsolz.consent('granted') from your cookie banner once the visitor agrees. Until then the widget stays in the anonymous mode above. Call Softsolz.consent('denied') to drop back and erase the stored id.

// call this when the visitor accepts analytics cookies
window.Softsolz.consent('granted')

// call this if they decline or withdraw consent
window.Softsolz.consent('denied')

Prefer to use AI?

Copy this prompt and paste it into Cursor, Claude, Copilot or ChatGPT. Swap in your own public key and it will add the blog to your site for you.

Add my SoftSolz blog to my website.

1. Create a new, EMPTY page at the path /blog (no other content on it).
2. On that page, insert this HTML where the blog should render, keeping the script directly under the div:

<div id="softsolz-blog"></div>
<script src="https://app.softsolz.uk/softsolz.js"
  data-public-key="pk_live_your_key"
  data-service-id="blogs"
  data-mount="#softsolz-blog"></script>

Rules:
- Do not change the public key.
- If my site background is dark, add data-theme="dark" to the script tag.
- Keep the div and script together, in that order.
- Then tell me the URL of the page to open and test.

Read posts from your server

curl https://app.softsolz.uk/api/v1/services/blogs/posts/published \
  -H "Authorization: Bearer sk_live_your_key"