This is a DRAFT. These guidelines are a work in progress and open for discussion. Please reply with suggestions, corrections, or questions. Once finalized, this topic will become a wiki for ongoing community editing.
What is the Books Catalog?
The Books catalog documents the existence of books, magazines, journals, and other printed or published materials. We catalog metadata (titles, authors, publishers, ISBNs, images), not content. Do not upload copyrighted text or reproduce the contents of books.
What Belongs Here
- Fiction and non-fiction books
- Magazines, journals, and periodicals
- Chapbooks, pamphlets, zines
- Audiobooks and e-books
- Box sets and collected editions
- Sheet music publications
- Academic publications
What Does NOT Belong Here
- Comics and graphic novels
- Brochures and product catalogs
- Postcards, sticker albums, phone books
- Homework, letters, notes, user manuals
Comics vs. Books: Graphic novels, comic strip collections, and comic book collections do not belong in the Books catalog. The deciding factor: if the majority of action and dialogue happens in illustrated panels (sequential art), it doesn’t belong here. If illustrations decorate a text narrative, it belongs in Books.
The Data Model
The Books catalog has three entity types:
Book
A Book is the umbrella entry that groups all editions, translations, and printings of the same title together.
A Book does not physically exist — it represents the concept: “Moby-Dick by Herman Melville” regardless of which publisher printed it.
Edition (Physical Publication)
An Edition is a specific physical (or digital) published object — the thing you hold in your hands, put on your shelf, buy, and sell. Every distinct printing, translation, or format of a book is a separate Edition.
Each Edition is linked to a Book. Even if a book has only one known printing, it still has one Edition under one Book.
Credit (Person or Company)
A Credit represents a person or organization: an author, publisher, illustrator, printer, editor, imprint, or any other credited entity. Credits are shared across Books and Editions — for example, the same “Faber & Faber” Credit is linked from every Edition they published.
Why “Book” and “Edition”?
The terminology can be counterintuitive because in everyday language we say “I have a book” when we mean the physical object. Another example: when someone says “I read that book,” they’re referring to the Book — not any specific printing or edition. On ctlgs:
- Book = the title + author (groups all editions together)
- Edition = the physical object (a specific printing you can hold)
Some contributors use capitalization to distinguish: “Book” (the entity) vs. “book” (the everyday word).
Which Form to Use
Combo Form (Book + Edition)
The combo form creates a Book and Edition together in one step, automatically linking them. This is the recommended way to add a new entry to the database.
Use it when: You’re adding a title that doesn’t yet exist in the database, along with your specific copy.
How it works:
- Select “Book + Edition” from the submission options
- Fill in the Book section (title, author, genre, etc.)
- Fill in the Edition section (format, publisher, ISBN, etc.)
- Write a submission summary and submit — both entities are created and linked
Edition-Only Form
Use it when: The Book already exists and you’re adding another edition of it. You can also use the “Add Edition” button on a Book’s page.
Book-Only Form
Use it when: You want to create a Book entry without adding a specific edition yet (rare).
Credit Form
Use it when: You need to create or edit a person or company entry — adding a biography, external links, etc. Credits can also be created inline while editing a Book or Edition.
Edit Form
The standard edit form provides labeled fields for all entity properties. It auto-generates from the schema and handles linked entities (credits, books) with search-and-select dropdowns.
Edit Images Page
A dedicated page for managing an entity’s images. You can upload, reorder (drag and drop), enable/disable, and delete images.
Book Fields
Title (required)
The title of the book. Enter it in the language of first publication.
If the book was originally published in Japanese, the title should be in Japanese. If it was originally published in English, use the English title.
English Title
If the Book title is not in English, enter the English translation of the title here. This helps English-speaking users find the book in search — a book titled “Vier Hochzeiten und ein Todesfall” won’t appear when someone searches “Four Weddings and a Funeral.”
- If there is a well-known published English title (from an English translation), use that
- If there is no accepted English title, provide a reasonable translation — other users can refine it later
- If the book was originally published in English, leave this blank
Authors
Link to the Credit entity for each author. Start typing to search for existing Credits, or create a new one inline.
For anthologies or collections with multiple authors, list the editor(s) here if they are the primary credited name on the cover.
Genre
Select one or more genres from the dropdown. You can also type custom genres not in the preset list — popular custom genres may be added to the dropdown over time.
Genres describe the content of the book, not the format. Some genre entries describe the form/structure (e.g., Novel, Novella, Short Stories, Essays) — these are valid and help categorize what kind of Book it is.
Languages
The original language(s) of the book.
Dates
Dates associated with the book as a whole:
- First Published — when it was first published in any form
- Copyright — the original copyright date
External Links
Links to relevant external resources (e.g., Wikipedia article, publisher page, author’s website).
Notes
Free-text notes about the book. Use sparingly for information that doesn’t fit elsewhere.
Edition Fields
Title (required)
The title as printed on this specific Edition. This may differ from the Book title for translations, revised editions, or alternate printings.
Book
The linked Book entity. Every Edition should be linked to a Book.
Credits
The people and organizations credited in this specific Edition. Each credit has a role and a name (linked Credit entity).
Common credit roles to always include:
| Role | When to Use |
|---|---|
| Author | The writer of the text |
| Publisher | The publishing house |
| Imprint | A subdivision/brand under which the publisher publishes |
| Illustrator | Artist who created interior illustrations |
| Cover Art by / Cover/Jacket Design by | Cover artist or designer |
| Printed by | The printer (if stated in the book) |
| Translated by | For translations |
| Editor | If this is an edited collection |
| Foreword by / Introduction by / Afterword by | Authors of supplementary text |
| Designed by | Interior/book designer |
| Typeset by | Company that did the typesetting |
| Publisher Series | The series within a publisher (e.g., “Penguin Classics”) |
There are over 450 roles available. If none fits, select “Other.”
Display As (Name Variations)
If a credit is printed differently on the Edition than their main profile name (e.g., “Faber and Faber” instead of “Faber & Faber”), you can use the Display as feature. Click the edit link next to a credit to set the display text.
The linked Credit stays the same — only the displayed text changes. An asterisk (*) appears after credits with a custom display name.
Format
The physical format of the Edition:
Flexible covers: Paperback, Mass-Market Paperback, Trade Paperback, Soft Cover, Flexibound
Rigid covers: Hardback, Board Book
Periodicals: Magazine, Pulp Magazine, Bedsheet Magazine, Digest, Journal
Other: Audiobook, e-Book, Chapbook, Zine, Box Set, Spiral-Bound, and more
Language
The language of this specific Edition (may differ from the Book’s original language for translations).
Location
The publisher’s location as printed on the title page or copyright page. This was one of the most debated fields on Bookogs, so here is the guidance:
What to enter: The city and/or country as printed in the book. Example: “Oxford; New York” if both are printed on the title page.
What NOT to enter:
- Where the book was manufactured/printed (use a “Printed by” credit for that)
- The territory of sale (unless that is specifically what is printed)
- Long lists of publisher office addresses
If the book does not print a location, leave this field blank rather than guessing.
Dates
Dates specific to this Edition. Use the type dropdown to indicate what each date represents:
- This Edition Published — when this specific edition was published
- First Printing — date of the first printing of this edition
- Reprinted — reprint date(s)
- Copyright — the copyright date printed in this Edition
- Cover Date — for periodicals, the date printed on the cover
- This Impression — if the impression date is printed
- First Published — can repeat the first publication date for reference
Enter dates as they appear in the book. Format is flexible — YYYY, YYYY-MM, or YYYY-MM-DD are all acceptable.
Page Count
Enter the highest printed page number in the book.
If the book has roman numeral front matter (e.g., xvi pages) followed by numbered pages (e.g., 500 pages), enter “500” — the highest printed number.
For books where numbering restarts (e.g., two works in one volume, each starting at page 1), use the format “250 & 250” and explain in the Notes field.
Identifying Codes
One of the most important sections for distinguishing different Editions. Add all codes printed in your copy:
- ISBN 13 / ISBN 10 — The International Standard Book Number. Always add if present.
- SBN — The older 9-digit standard (pre-1974).
- ISSN — For periodicals/serials.
- Barcode (EAN/UPC) — The barcode number, if different from the ISBN.
- Printer’s Key — The number line on the copyright page (e.g., “2 4 6 8 10 9 7 5 3 1”). Crucial for identifying specific printings.
- Series Number — The number within a publisher’s series.
- Volume Number / Issue Number — For periodicals.
- Edition No. — The edition number (1st edition, 2nd edition, etc.)
- Impression/Printing No. — The impression or printing number, if stated or derivable.
- Price — The printed cover price.
- Library of Congress Catalog Card Number — If printed (usually on verso of title page).
- Dewey Decimal Classification Number — If printed (usually on verso of title page).
- Catalog Number / Product Code — Publisher’s internal code.
Font
The typeface used for the body text, if stated in the book (often on the copyright page or in a colophon).
Chapters
A list of chapter titles or table of contents. Useful for collections, anthologies, and multi-work volumes.
Notes
Free-text notes about this specific Edition:
- Print history details
- Distinguishing features of this printing
- Errors or corrections in the text
- Details about variant covers or dustjackets
Credit Fields
Title (Name) (required)
The primary name of the person or organization. Use the most commonly known form of the name.
For pen names, use the pen name if that’s how the person is primarily known (e.g., “Mark Twain” not “Samuel Clemens”). The real name can be recorded in the Credit’s profile.
Profile
A short biographical note or description. Optional.
External Links
Links to relevant external resources (personal website, Wikipedia, publisher website).
Publishers and Imprints
An imprint is a subdivision or trade name under which a publisher publishes. One publisher may have several imprints (e.g., Penguin Random House publishes under dozens of imprints).
How to credit publishers and imprints:
- Always add the Publisher credit
- If the book is published under a specific imprint, also add an Imprint credit
- If the book says “Published by X, an imprint of Y,” credit X as Imprint and Y as Publisher
- When a publisher has changed names over the years, use the name as it appeared at the time of publication
- If the book is part of a publisher series (e.g., “Oxford World’s Classics”), add a Publisher Series credit
How Closely Related Must Editions Be?
Editions of a Book should represent substantially the same title. This includes:
- Different printings (hardback, paperback, reprints)
- Different translations
- Revised or expanded editions (if the core content is the same)
- Different formats (print, audiobook, e-book)
Editions should NOT be linked under the same Book if:
- A short story is entered as a “Book” and anthologies containing that story are entered as “Editions” — this is incorrect. As discussed in the forum: “A book can contain a story, but a story cannot contain a book.” Each anthology should be its own Book.
- Two completely different books happen to share a title
- A compilation fundamentally changes the nature of the content
Rule of thumb: If you would describe one Edition as “a different printing of” or “a translation of” the other, they belong under the same Book. If they are substantially different books that happen to share content, they should be separate Books.
Duplicate Book Titles
Book titles do not need to be globally unique. If two completely different books share the same title (e.g., two different novels both called “The Road”), simply create two separate Books with the same title. The author and cover images will differentiate them. There is no need for a “(2)” suffix.
Duplicate Credit Names
When two different people or companies share the same name, use numbered disambiguation: “John Smith” for the first entry, “John Smith (2)” for the second.
Do not add role qualifiers to names (e.g., avoid “John Smith (Illustrator)”) — this causes problems when a person works in multiple roles.
The first-created Credit keeps the plain name. New, different entities with the same name get the number suffix. Do not rename existing Credits to add numbers.
Incorrect Credits (Miscredits)
If a book prints an incorrect credit (e.g., wrong illustrator name), enter the credit as printed in the book. Use the Notes field to explain the error. This preserves the fidelity of what is actually printed while documenting the correction.
Periodicals (Magazines, Journals)
Magazines and periodicals belong in the Books catalog. The recommended approach:
- Each issue is an Edition
- Use the Periodical Title credit role to link to the magazine series Credit
- Set the appropriate format: Magazine, Digest, Pulp Magazine, Bedsheet Magazine, Journal, Zine, etc.
- Use Volume Number, Issue Number, and Cover Date in the identifying codes and dates
- Issues may optionally be grouped under a Book, but it is acceptable to create Editions without a Book for periodicals
Images
Image Order
Follow this order when uploading images:
- Front cover — Always the primary image. If there is a dust jacket, photograph it with the jacket on.
- Spine — Vertical format, as the book would sit on a bookshelf.
- Back cover
- If images 1–3 were with a dust jacket, images 4–6 can repeat the process without the jacket (front, spine, back).
- Title page — Usually near the front, showing title, author, and publisher. If the title page spans two pages, photograph both as a single image.
- Copyright page (colophon/verso of title page) — Contains publishing details, print history, and identifying codes.
- Contents page and any other pages that help identify the edition.
Image Guidelines
- Maximum image size: 10 MB
- Do NOT upload full book contents. We catalog the existence of books, not reproduce them. Uploading copyrighted text is not permitted.
- Dust jacket inner flaps are usually unnecessary unless they help distinguish editions/printings.
- If the front cover is missing or damaged, use the title page as the primary image.
- For children’s books or non-standard layouts, arrange images in the order they appear in the book.
Collections
The Books catalog supports three collection lists, available on Editions:
- Collection — Editions you own
- Read — Editions you have read
- Wantlist — Editions you want to acquire
Tips for New Contributors
- Search first — Before adding a new Book, Edition, or Credit, search to make sure it doesn’t already exist. Use ISBNs, titles, and author names to check.
- Enter what you see — Transcribe data from the physical book in front of you. Don’t guess or look things up on other sites if the information isn’t in the book itself.
- ISBNs matter — Always enter ISBNs and other identifying codes. They are the primary way to distinguish editions.
- Images help — Even one or two photos of the cover and copyright page make an entry much more useful.
- Use the summary field — When submitting or editing, write a brief note explaining what you added or changed (e.g., “Initial creation” or “Added ISBN and printer’s key”).
- Link credits properly — Search carefully for existing Credits before creating new ones. Check for name variations.
- Ask in the forum — If you’re unsure how to handle a specific case, ask in the community forum. Many common questions have already been discussed.
These guidelines are a DRAFT and will be updated as conventions evolve. Discussion and suggestions are welcome — please reply below.