How to Use the Zotero Better BibTeX Citation Key Prompt to Stop Breaking LaTeX Builds

Nothing stalls a paper like a citation key that renamed itself overnight after someone edited a title. Coauthors pull a fresh .bib, Pandoc fails, and half the cite commands turn red. The Zotero Better BibTeX Citation Key Planner: Key Formula, Conflict Policy, JabRef Export Map, and a LaTeX Bib File Hygiene Checklist prompt designs a Better BibTeX formula, a pin policy, an export map for BibLaTeX, and a hygiene checklist so keys stay stable from draft through camera ready.

What the prompt produces

1. A citation key formula using Better BibTeX placeholders with a rationale matched to your style family.
2. A conflict policy for duplicate keys, pinning, and when auto rename must stop.
3. Item type rules so books, chapters, web pages, and datasets do not collide with articles.
4. An export map for BibTeX, BibLaTeX, or CSL JSON, including fields to strip.
5. A coauthor README blurb you can drop next to the Overleaf git bib.
6. A hygiene checklist for DOIs, dates on web pages, and duplicate items.
7. Worked examples showing exact keys for imaginary references.
8. A rollback note for pinning before a formula change and searching the .tex files.

How to fill the inputs

FieldAndStyle should name the discipline and whether you use authoryear BibLaTeX, APA via CSL, or numeric IEEE. The formula follows that choice.

ZoteroSetup needs the Zotero generation and whether Better BibTeX is installed. If it is not, the prompt still plans the formula but will tell you to install first.

CollabModel matters. Solo libraries can be looser. Shared Overleaf git bibs need a pinned README or someone will "improve" the formula mid revise.

PainPoints should be concrete: keys changing after title edits, Smith 2024 collisions, web pages with blank years.

ExportTarget selects Better BibLaTeX versus BibTeX flavor and whether JabRef groups belong in the file.

Reading the example output

The sample is political science on BibLaTeX authoryear with two coauthors and an auto exported refs.bib.

• The formula uses author, year, and one shorttitle word so same year authors stay distinct.
• Pinning is required before submission, which is the real fix for rename accidents.
• Web pages without dates get an explicit nodate pattern instead of silent empties.
• The README tells coauthors not to hand edit keys in the .bib, which prevents the most common Overleaf fight.

Tips for better results

• Pin every cited item before you change the formula, even for a "small" tweak.
• Fill dates on web pages before export day, not during the camera ready crunch.
• Keep abstracts out of the .bib if Overleaf compile times matter.
• Store the formula string in the repo README so a new RA does not invent a second scheme.
• After export, spot check three cite keys against the PDF before you call the build green.

Mistakes to avoid

• Do not invent Better BibTeX preference labels. Mark confirm gaps and look them up in the plugin.
• Do not delete a group library as cleanup. Export a backup first.
• Do not mix hand typed keys with auto keys in the same paper.
• Do not strip DOI fields if your style needs them for links.

Who it is for

Graduate students, research librarians, and labs that keep Zotero as the source of truth for LaTeX or Pandoc papers.

If you are migrating from EndNote or a hand maintained .bib, run the hygiene checklist before you flip auto export on. A dirty library with pinned wrong keys is harder to unwind than a clean import with a documented formula.

Related PromptDig links

Open the Zotero Better BibTeX Citation Key Planner: Key Formula, Conflict Policy, JabRef Export Map, and a LaTeX Bib File Hygiene Checklist prompt with your style and collaboration model. For more research workflow prompts, Browse more prompts. If you have a BBT formula that survived a dissertation, Share a prompt.