Help: Widget

Documenting the features of Twingly


To contents

Our free widget platform gives bloggers the ability to display relevant content from our search on their blogs. You can now easily let your readers see who has linked to your blog or what posts that has the highest TwinglyRank. Any search result is available in an easy to use widget. (Free for non-commercial use, for commercial use see Blog Box.)

Getting the widget

The installation process is aimed to be simple and fast. The easiest way is to start by finding a widget you would like to put on your blog and click "Get this widget for your blog" at the bottom. You can also find the same link at the bottom of any search result. For inspiration, have a look at the blog profile page for any blog, like the profile for our blog.

When clicking the "Get this widget" link, a popup window will appear. It contains the HTML you need to include in your page template. Next, do the following steps:

  • Copy the content of the first text area and put it where ever you want the widget to appeare on your blog.
  • Change the value in the <span class="query">blog:http://change_this_to_yourblogurl</span> to the url for your blog.
  • Copy the content of the second text area (the script tag) and put it just before the closing </body> tag.

When you are done, your page template should look something like this:

        <!-- some html -->
        <div class="twingly_widget">
            <a href="">Twingly Blog Search</a>
            <span class="query">link: sort:published</span>
            <span class="title">Most recent posts linking to Twingly Blog</span>

        <!-- some more html -->

        <script type="text/javascript" src=""></script>

And now your done! Sit back and marvel at the beauty appearing on your blog.


We have created 3 example widgets (queries), just replace with the address to your blog.

  • The most recent posts linking to a blog:
    <div class="twingly_widget">
        <a href="">Twingly Blog Search</a>
        <span class="query">link: sort:published</span>

  • The most linked posts:
    <div class="twingly_widget">
        <a href="">Twingly Blog Search</a>
        <span class="query">blog: sort:inlinks</span>
        <span class="template">ShowBlog=no</span>

  • The latest published posts:
    <div class="twingly_widget">
        <a href="">Twingly Blog Search</a>
        <span class="query">blog: sort:published</span>
        <span class="template">ShowBlog=no</span>

Including widgets on your page

Remember! You also need to include this at the bottom of the page, or page template, for the widget to work. Place it just before the closing </body> tag.

<script type="text/javascript" src=""></script>

To use any of these, all you have to do is change the address (URL) to your blogs address as mentioned above.

Customize it!

The Twingly widgets are build so that it should be easy to customize both its content and the way it looks. As long as you agree to the Terms of use you are free to do pretty much anything (for commercial use see Blog Box). In fact, we would love to see you do something cool with it.

To customize the widget, you can use the following configuration fields:

  • query — use to specify the query:

    Example: <span class="query">* sort:published</span>

  • title — use to specify the title that is shown in the widget:

    Example: <span class="title">Recent blog posts linking to my blog</span>

  • count — use to limit the number of posts shown (maximum is 10, default is 5):

    Example: <span class="count">3</span>

    The number of results returned from a search is always at most 10. The actual number of results depends on what the search returned, count is used to limit the maximum number of posts shown. Use count if you want to show for example only 3 items.

  • template — use to specify a pre-defined template option:

    Example: <span class="template">ShowBlog=no</span>


    • ShowBlog=no: For use when showing information about a blog. Hides the RSS icon and the link to the blog.

The core functionality of the widgets is to display search results. What will be displayed is therefore decided by the search query.