embeds allow you to add new altmetrics data to your content with a minimum of fuss and technical effort – all you need to do is add two lines of code to your HTML. We host the altmetrics data that your readers will see, but give you control over their presentation.

The process involves three steps:

  1. Ensure we are tracking your domains;
  2. Ensure you have identifying metadata on your article pages;
  3. Add our badge code to your pages;

Ensure we are tracking your domains

To properly track your content, we need to know the domain names on which you’ll be using the badges: e.g.,

For publishers: if any journals on your platform have their own custom domains, e.g.,, please tell us about those too by emailing

Ensure you have identifying metadata on your article and/or book pages

In order to disambiguate mentions of articles, we look for identifiers such as DOIs, PubMed IDs and arXiv IDs in your pages. To ensure we can do this easily, it helps if you follow Google Scholar’s “Inclusion Guidelines for Webmasters” ( specifically adding meta-tags with DOIs or PubMed IDs like so at the top of your pages:

<meta name="citation_doi" content="10.1234/journal123">
<meta name="citation_pmid" content="1234">
<meta name="citation_arxiv_id" content="12345">

We also look for meta-tags specific to certain repository software such as Bepress like so:

<meta name="bepress_citation_doi" content="10.1234/journal123">

(You can find the full list of metadata tags we support at the bottom of this page.)

If you are unable to make such changes to your article pages, please get in touch with us at to see if we could add a custom integration to identify your articles (perhaps by placing an ID in another location).

Add our badge code to your pages

You can find complete instructions on using our embeddable badge code at and even interactively build your own snippet using our interactive form at

The high level overview is that you need to add the following snippet to your HTML:

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

Then wherever you want to place a badge, you add an element like so:

<div class="altmetric-embed" data-badge-type="donut" data-doi="10.1038/nature.2012.9872"></div>

Where the data-doi attribute contains the DOI of the article for which you wish to display a badge.
If you don’t have DOIs then you can use handles or PubMed IDs instead like so:

<div class="altmetric-embed" data-pmid="21148220"></div>
<div class="altmetric-embed" data-handle="10255/dryad.40269"></div>

If your platform doesn’t allow you to specify data- attributes, you can also use CSS classes instead like so:

<div class="altmetric-embed altmetric-badge-type-donut altmetric-badge-popover-left altmetric-doi-10.5339/connect.2012.9"></div>

What if I want a richer integration and access to the underlying data?

If you want to develop against the raw Altmetric API rather than using the embeddable badges then please get in touch with to request an API key.

Supported metadata tags

Please note that all tag names are case-insensitive.

DOIs & Handles

  • citation_doi
  • doi
  • DC.Identifier
  • DC.DOI
  • DC.Identifier.DOI


  • bepress_citation_doi
  • rft_id

PubMed IDs

  • citation_pmid

arXiv IDs

  • citation_arxiv_id


  • citation_abstract_html_url


  • citation_author
  • bepress_citation_author
  • DC.creator

Article titles

  • DC.title
  • citation_title
  • bepress_citation_title


  • citation_issn
  • bepress_citation_issn


  • citation_isbn

Journal titles

  • citation_journal_title
  • bepress_citation_journal_title

Journal issues

  • citation_issue

Journal volumes

  • citation_volume


  • citation_publisher
  • bepress_citation_publisher

Publication dates

  • citation_online_date
  • bepress_citation_online_date


  • citation_pdf_url
  • bepress_citation_pdf_url