Datasheets
Import PDF datasheets, follow processing, handle locked PDFs, and let the agent search and cite them.
Import a component's PDF datasheet and Embedr turns it into indexed text and figures the agent can search and quote: pin tables, absolute maximum ratings, timing diagrams, register maps. Processing runs in the cloud, so you need to be signed in and online.
Import a PDF
There are three ways in:
| Where | How |
|---|---|
| File explorer | The Upload Datasheet drop zone ("Click or drop PDF"). Click it to pick a PDF or drop one on it |
| Chat composer | Attach, drop or paste a PDF. It is processed first, then attached to your message as a datasheet |
| Home screen | Attach a PDF to the first prompt; it is processed once the project exists |
You can also ask the agent: "Index the datasheet at docs/TPS62840.pdf" or give it a link to a manufacturer PDF. It shows an Index datasheet row while it works.
A PDF attached in chat can only be processed inside a project ("Open a project before attaching datasheets.").
Processing
The drop zone turns into a progress card: Processing datasheet, a percentage, and the current step, for example:
- Validating file...
- Uploading file...
- Detected 84 pages...
- Parsing PDF... (large files are split: "Parsing chunk 2/4")
- Extracting tables and diagrams...
- Generating searchable index...
- Publishing datasheet...
- Complete!
Click Cancel on the card to stop. While a PDF attached in chat is processing, its tile shows the progress and the message cannot be sent yet.
With Auto-Generate Datasheet Names on (Settings → General), Embedr names the datasheet after the component rather than the file name.
Limits
| Limit | Value |
|---|---|
| File type | PDF only ("Only PDF files are supported") |
| File size | 200 MB |
| Pages | 1,000. Split longer manuals and upload the section you need |
| Account | Signed in ("You must be signed in to process datasheets") |
Locked and encrypted PDFs
| Result | |
|---|---|
| Opens without a password but restricts copying or printing | Unlocked automatically and processed |
| Needs a password to open | Refused: "This PDF is password-protected. Please upload an unlocked copy or export it without password protection." |
| Uses an encryption mode the parser cannot handle | Refused: "This PDF uses an encryption mode the parser cannot normalize yet. Please export it as an unlocked PDF and try again." |
| Encrypted and very large or complex | Refused: "This encrypted PDF is too large or complex to unlock. Please export it as an unlocked PDF and try again." |
To unlock a PDF you are allowed to use, open it with the password in a PDF viewer and print or export it to a new PDF.
Browse your datasheets
Processed datasheets are listed in the file explorer under Datasheets, with a count. Each row shows the component name and its ID. Click a row to open it in a tab:
| Control | Shows |
|---|---|
| Processed | The extracted Markdown: text, tables and figures |
| Original PDF | The PDF as uploaded |
| Open page | The datasheet's page in your browser |
If the tab says Datasheet not indexed, the project references a datasheet that has not been processed yet. Drop the PDF on the Datasheets section again, or ask the agent to index it. Rows labelled "Local datasheet" come from older Embedr versions and must be indexed again before the agent can search them.
How the agent uses them
The agent finds and reads datasheets with these actions, each shown as a row in the timeline:
| Row | What it does |
|---|---|
| List datasheets | Lists what the project has indexed |
| Search datasheets | Finds the passages that answer a question, for example Searched TPS62840 for "quiescent current" |
| Read datasheet | Reads a whole datasheet, its metadata, or specific sections |
| Index datasheet | Processes a new PDF or URL |
Expand a row to see the passages it returned. To point the agent at one datasheet, type @ in the composer and pick it; datasheets are listed with project files.
Ask questions that send it back to the source:
Using the BME280 datasheet, make a wiring table for the ESP32-S3 over I2C at 3.3 V, with pull-up values, and cite the section for each limit.
What is the absolute maximum on the EN pin of the TPS62840, and does our 5 V USB rail violate it?
Compare the sleep current of the two LoRa modules I imported and say which one meets 2 µA.
The agent may also read datasheets on its own while choosing parts, writing drivers or checking a schematic. Plan Mode never reads datasheets; it lists them under To research for implementation.
Generated text can be wrong. Before powering hardware, check supply range, absolute maximum ratings, pin direction, pull-ups and level shifting against the original PDF.
Where they live
The processed datasheet is stored in Embedr's cloud with your account. The project keeps the reference:
my-project/
.embedr/
datasheets.json # the project's datasheet index
embedr.yaml # mirrors the list under datasheets:
The datasheets: entry in embedr.yaml looks like:
datasheets:
- id: <datasheet id>
name: BME280
originalFilename: bst-bme280-ds002.pdf
chunkCount: 142
imageCount: 18
processedAt: 2026-10-20T09:14:02.000Z
Entries also carry links to the processed page, its Markdown and its search. Do not edit them by hand.
Datasheets attached to parts in the component library are separate and come with the part.
Tips
- Use the manufacturer's own datasheet, one component per PDF. Catalogues of many parts are harder to search.
- If extraction of a scanned or unusual PDF is poor, attach a screenshot of the critical table to your chat message as well.
- Keep project-specific facts (chosen I2C address, pins in use) in your own notes or spec, not in the datasheet.
Troubleshooting
| Message | Fix |
|---|---|
| "File too large (250MB). Maximum size is 200MB." | Split the PDF or export the relevant chapters |
| "This PDF has more than 1000 pages…" | Upload a section under 1,000 pages |
| "Network error while uploading datasheet." | Check your connection and retry |
| "Datasheet upload canceled." | You clicked Cancel; drop the PDF again |
