How many works cite a record and which, each with its index and when that was read.
<div data-mount="count"></div>
Installation
// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/cited-by.css";
import "capsomer/tokens.css";
import "capsomer/cited-by.css";
import { CitedByCount, CitedBy } from "capsomer/react/cited-by";
Usage
<p class="cap-cited-by-count"><a href="https://example.org/works?cites=example">Cited by 12</a> <span class="cap-cited-by-source">Example Index, read 2026-11-01</span></p>
<section class="cap-cited-by" aria-labelledby="cb">
<h2 class="cap-cited-by-title" id="cb">Cited by 25 of 40</h2>
<p class="cap-cited-by-source">Example Index, read 2026-11-01. Newest first.</p>
<ol class="cap-cited-by-list">
<li><a href="https://doi.org/10.5555/example">Field notes from a second season</a><span class="cap-cited-by-source">, Example Journal</span><span class="cap-cited-by-source">, 2026</span></li>
</ol>
</section>
Examples
The count without a link, and no count drawn below 1
<div data-mount="count-plain"></div>
<div data-mount="count-zero"></div>
The list, all of it
<div data-mount="list"></div>
The list, fewer than the count, with missing fields
<div data-mount="capped"></div>
API reference
CitedByCount
| Prop | Type | Required | Does |
|---|
count | number | null | undefined | Yes | The count the index reports. Below 1 nothing is drawn: a cold cache must not look like a measured zero. |
|---|
href | string | null | | The index's page of citing works, when there is one. |
|---|
source | string | Yes | Where the count comes from and when it was read: "OpenAlex", "2026-11-01" or a Time. |
|---|
readAt | ReactNode | | |
|---|
CitedBy
| Prop | Type | Required | Does |
|---|
total | number | Yes | The true count, which may be more than works holds. |
|---|
works | readonly CitingWork[] | Yes | |
|---|
source | string | Yes | |
|---|
readAt | ReactNode | | |
|---|
order | string | | How the list is ordered, said after the source: "Newest first." |
|---|
headingLevel | 2 | 3 | 4 | | |
|---|
Parts and data attributes
| Class | Is |
|---|
.cap-cited-by | the root |
|---|
.cap-cited-by-count | a part |
|---|
.cap-cited-by-list | a part |
|---|
.cap-cited-by-source | a part |
|---|
.cap-cited-by-title | a part |
|---|
Accessibility
| Key | Does |
|---|
| Tab | Moves through the count's link and each work's link, as any link |
- The list is a labeled
section (its heading) and an ordered list. - Titles are text links; the provenance, venue and year are
--muted at 4.5:1.