> For the complete documentation index, see [llms.txt](https://docs.labii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.labii.com/widgets/section-widgets/reference-manager/pubmed/pubmed-abstract.md).

# PubMed Abstract

## Specs

| Label                     | Value                         |
| ------------------------- | ----------------------------- |
| **Version**               | 3.0.0 (updated on 2023-03-02) |
| **Developer**             | Labii Inc.                    |
| **Type**                  | Section                       |
| **Support Configuration** | Yes                           |

## Overview

The PubMed Abstract widget downloads and displays the abstract for a paper identified by a PubMed ID within a Labii record. It is designed for literature review, protocol background, and experiment planning workflows where researchers need the paper abstract available directly in the ELN or LIMS without opening PubMed separately. Once the widget is linked to a PMID column, Labii can automatically retrieve the abstract, store it for later use, and show it in a read-only section for convenient reference.

## Use Cases

* **Literature Review**: Display the abstract of a cited paper directly in the record so researchers can review background information while working.
* **Reference Management**: Keep abstracts attached to paper records in Labii for faster searching and comparison of sources.
* **Experiment Planning**: Show supporting publication abstracts next to protocols, results, or study notes.
* **Knowledge Capture**: Preserve the retrieved abstract in Labii so the record keeps important publication context even after the initial lookup.
* **Preconfigured Applications**: Use the widget immediately in Labii Reference Manager, where the PMID mapping is already configured.

## Interface

### Read-only View

In read-only mode, the widget displays the saved abstract text for the current paper. This is the main consumption view for scientists who want quick access to the publication summary without editing the section. If the abstract has already been retrieved and stored, the widget simply shows it as part of the record.

* **Data Display**: Shows the abstract text associated with the current record's PubMed ID.
* **Navigation**: Supports record-level review of publication details alongside other sections and columns.
* **Export Options**: The widget does not provide a dedicated export action for abstracts.
* **Search/Filter**: Search is handled by the surrounding record or table tools rather than inside the widget itself.

<figure><img src="/files/JBdLGsqQ5VucGvKQdEoI" alt="Read-only view of the PubMed Abstract widget"><figcaption><p>The read-only view displays the downloaded PubMed abstract as part of the current Labii record.</p></figcaption></figure>

### Edit View

In edit or configure mode, users define which column contains the PMID value that the widget should use for the lookup. This is typically a one-time setup for a table or template. After the PMID column is selected, the widget can use that value to retrieve and refresh the abstract when the paper record is opened or updated.

* **Input Methods**: Select the column that stores the PubMed ID for the current table.
* **Formatting Options**: The edit view focuses on configuration rather than text formatting.
* **Validation**: The widget requires a valid PMID column mapping; if the column is missing or invalid, the abstract cannot be retrieved correctly.
* **Collaboration**: Once configured, all users of the table or template can view the same abstract retrieval behavior consistently.

<figure><img src="/files/JBdLGsqQ5VucGvKQdEoI" alt="Configure view of the PubMed Abstract widget"><figcaption><p>The edit or configure view links the widget to the column that stores the PubMed ID used for abstract retrieval.</p></figcaption></figure>

## Configuration

### Initial Setup

The PubMed Abstract widget must know which column contains the paper's PMID. In Labii Reference Manager, this mapping is already preconfigured, so no extra setup is usually required.

{% stepper %}
{% step %}
Add the **PubMed Abstract** widget to a section in the target record layout or table template.
{% endstep %}

{% step %}
Open the widget in **Edit** mode or click the configuration control.
{% endstep %}

{% step %}
Select the column that stores the PubMed ID for the record.
{% endstep %}

{% step %}
Save the configuration and open a record with a valid PMID to let the widget retrieve the abstract.
{% endstep %}
{% endstepper %}

### Required Settings

* **PMID Column**: Select the column that stores the PubMed ID. The widget uses this value to query PubMed and retrieve the paper abstract.

### Optional Settings

* **Preconfigured Reference Manager Setup**: In Labii Reference Manager, the PMID column mapping is already configured, so users can typically use the widget without additional setup.

{% hint style="info" %}
If you are using the standard Labii Reference Manager application, the PubMed Abstract widget is already configured to use the PMID column.
{% endhint %}

### Advanced Configuration

For reusable table templates, configure the PMID column once at the template level so every new paper record inherits the correct abstract lookup behavior.

{% stepper %}
{% step %}
Open the table template or record layout where paper records are created.
{% endstep %}

{% step %}
Add the widget and map it to the correct PMID column before the template is published to users.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
If the widget is mapped to the wrong column, or if no valid PMID is present in the record, PubMed abstract retrieval will fail or show an error.
{% endhint %}

## Additional Functions

### Automatic Abstract Download

After the widget is configured, Labii automatically downloads the abstract when the record is opened and the abstract is not already stored locally.

{% stepper %}
{% step %}
Open a record that contains a valid PMID in the configured column.
{% endstep %}

{% step %}
Allow the widget to query PubMed and retrieve the abstract.
{% endstep %}

{% step %}
Review the downloaded abstract in the section once it is displayed.
{% endstep %}
{% endstepper %}

### Update Abstract

If the PMID changes or the saved abstract needs to be refreshed, users can trigger a new retrieval.

{% stepper %}
{% step %}
Update the PMID value in the configured column if needed.
{% endstep %}

{% step %}
Click **Update Abstract** in the widget.
{% endstep %}

{% step %}
Review the newly downloaded abstract in the read-only section.
{% endstep %}
{% endstepper %}

### Cached Storage for Retrieval

Once downloaded, the abstract is stored in Labii for later retrieval so the record can continue showing the abstract without requiring users to re-enter the paper details manually.

### Integration with Paper Records

The widget works especially well in paper-tracking workflows where the same record also stores citation metadata such as title, authors, journal, DOI, and related identifiers.

## Best Practices

### Data Quality

* Use authoritative PMID values copied directly from PubMed or trusted citation sources.
* Standardize the PMID column across paper tables so widget configuration stays consistent.
* Verify the PMID when an abstract fails to load before troubleshooting the widget itself.

### Workflow Design

* Add the widget to paper templates so every publication record includes the abstract section automatically.
* Pair the widget with citation and metadata fields so researchers can review the paper summary and bibliographic details together.
* Use the preconfigured Labii Reference Manager setup when possible to reduce manual configuration.

### Maintenance

* Use **Update Abstract** after changing a PMID to keep the displayed content aligned with the selected paper.
* Periodically review imported references for incorrect or incomplete PMID values.
* Keep section names clear so users can distinguish the abstract view from citation or full-reference sections.

{% hint style="success" %}
The most reliable setup is to standardize a single PMID column in your reference tables and configure the widget once in the table template.
{% endhint %}

### Common Pitfalls to Avoid

* **Avoid** mapping the widget to a text column that does not contain PMID values.
* **Avoid** expecting the widget to work without configuration in custom tables that do not use the preconfigured Reference Manager layout.
* **Instead** confirm the PMID column mapping first whenever the abstract does not appear.

## Related Widgets

* [**PubMed Citation**](/widgets/section-widgets/reference-manager/pubmed/pubmed-citation.md): Use this section widget when you want to display citation summaries for one or more PMIDs instead of the full abstract text.
* [**PubMed**](/widgets/column-widgets/pubmed.md): Use the column widget to store or sync PubMed-related metadata alongside the paper record.

## References

* [PubMed on Wikipedia](https://en.wikipedia.org/wiki/PubMed) - Background on the PubMed literature database and search system.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.labii.com/widgets/section-widgets/reference-manager/pubmed/pubmed-abstract.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.