Integrations

JS Embed

Embed a hosted blog on any site with one script tag.

The JS Embed (blog widget) drops your Grandranker articles into any website with one HTML snippet. Paste it into Squarespace, Wix (HTML block), Webflow (Embed element), a landing page, or plain HTML. The widget auto-loads and styles itself, and every article you publish in Grandranker appears automatically.

What you need: the ability to paste an HTML snippet into your site. A code/embed block, a custom-HTML element, or direct access to the page's HTML. No server-side changes are needed.

The embed is a legacy option. New accounts are led to the Hosted Blog instead. We host the blog on your own subdomain, so there is no snippet to maintain and a theme change on your site can't break it. Existing embeds keep working, and you can switch to the Hosted Blog whenever you like.

How to Connect

  1. In Grandranker, go to Integrations and choose the Blog widget (Embed Code) option.
  2. Copy the snippet shown on the page. It looks like this:
<div id="grandranker-articles"></div>
<script src="https://app.grandranker.com/embed/YOUR_TOKEN.js" async></script>
  1. Paste it into your site where you want the article list to appear. The widget needs no configuration on the host page.
  2. Back in Grandranker, click Activate embed. Once activated, every article you publish is automatically added to the feed the widget displays.

Some platforms (Squarespace, GoDaddy, Weebly, Duda and others) have their own guided version of this page with platform-specific setup steps. The snippet and behavior are the same.

Publishing & Verifying

Publish an article in Grandranker, then open the page where you pasted the snippet. The new article should appear in the widget's list. The integration screen also shows "Embed is active: articles appear automatically" once the embed is switched on.

Two optional feeds come with the embed, useful beyond the widget:

  • RSS feed: standards-compliant RSS 2.0 with full article content. Works with HubSpot, Zapier, IFTTT, n8n, Make, Feedly, or anything that imports from RSS.
  • JSON feed: prefer to build your own UI? Fetch the JSON URL directly. It's CORS-open and returns your published articles.

Both URLs are shown on the embed integration screen with copy buttons.

Troubleshooting

The widget shows nothing

Check three things in order:

  1. The embed is activated in Grandranker (the screen should say "Embed is active").
  2. Both lines of the snippet made it into the page: the <div id="grandranker-articles"></div> container and the <script> tag. Some editors strip script tags, so use the platform's dedicated code/embed block, not a rich-text field.
  3. You have at least one published article. Drafts do not appear in the feed.

Articles appear on the widget but styling looks off

The widget styles itself, but aggressive global CSS on the host page can override it. Try placing the snippet in a section without heavy custom styling.

Questions? Contact us at [email protected].

PreviousCustom APIReceive articles on your own endpoint via webhook/API.Next Hosted BlogA fully hosted blog on your own subdomain, no CMS required.