Skip to main content

Help page

Feeling lost? On this page you will find explanations of the basic concepts used across BookBrainz, as well as an F.A.Q and a glossary.
Still having some trouble with something? You can refer to the user guide and documentation, or come ask us directly on our IRC channel.

Entities

Entities are the main concepts used to describe a bibliographic record through their relationships

Entity relationships
AuthorAuthor – an individual, group or collective that participates in the creative process of an artistic work. It also includes translators, illustrators, editors, etc.
WorkWork – a distinct intellectual or artistic creation expressed in words and/or images. Here we are not talking, for example, about a physical book, but the introduction, story, illustrations, etc. it contains.
  • Examples: novel, poem, translation, introduction & foreword, article, research paper, etc.
SeriesSeries – a set or sequence of related works, editions, authors, publishers or edition-groups.
  • Examples: a series of novels, a series of comics, etc.
EditionEdition – a published physical or digital version of one or more Works.
  • Examples: book, anthology, comic book, magazine, leaflet
  • Note: An Author can self-publish an Edition
EditionGroupEdition Group – a logical grouping of different Editions of the same book.
  • Example: paperback, hardcover and e-book editions of a novel
PublisherPublisher – publishing company or imprint

Examples

The following examples should help you understand the different entities and how they relate to each other:
The relationship between H.P Lovecraft , his short story At the Mountains of Madness and an Edition The Classic Horror Stories which contain it and several more works.
Paperback and E-book editions of the novel Ancillary Mercy by the publisher Orbit Books making them part of the same Edition Group

Glossary

Here is a short description of some of the main terms you will encounter. Some terms are borrowed from MusicBrainz; click on the term to be redirected to the MusicBrainz guidelines or a definition.


Aliases – Variant names for an entity such as alternate spelling, different script, stylistic representation, acronyms, etc.
Example:
  • Name: 村上 春樹 – Alias (english): Haruki Murakami
  • Name: J.K. Rowling – Alias (full name): Joanne Kathleen Rowling – Alias (pseudonym): Robert Galbraith
Author Credits – As appearing on the publication cover. For example, if the author is using a pseudonym, the credits should reflect that.
Disambiguation – Short comment added to differentiate between similarly-named entities.
Example:
  • The Alchemist (philosophical novel) by Paulo Coelho
  • The Alchemyst (Nicolas Flamel biography) by Michael Scott
Entities – Conceptual items representing the various authors and parts of a publication. See the previous Entities section for details.
Format – Refers to different printing and/or binding methods, or digital distribution.
For example: paperback, mass-market, hardcover and e-book are all book formats
Identifiers – identity of an entity in other databases and services, such as ISBN, barcode, MusicBrainz ID, WikiData ID, etc.
When adding identifiers to an entity, you can enter either the identifier only (Q2517049) or a full link (https://www.wikidata.org/wiki/Q2517049).
Printing, print run, impression – A batch of identical copies of an edition of a work that is printed in a same, single production set-up.
One edition of a work may have any number of printings, e. g. a same Edition can have a first impression and a second impression.
Sort name – Modified name to help sorting alphabetically
Example:
  • Charles Dickens -> Dickens, Charles
  • A Tale of Two Cities -> Tale of Two Cities, A
  • Benito Pérez Galdós -> Pérez Galdós, Benito