Open Library logo
Last edited by Agent Sapphire
March 23, 2021 | History

Editing Open Library

How do I add a book?

Click on the "Add A Book" link under the More menu of every Open Library page and follow the instructions. Add a little information or a lot, you can always come back and enhance the book record you've created later. There is a note in your editing history any time you edit something, which makes a handy reference for you to find any pages you've had a hand in either creating or revising.

Top

Which types of books can I add to Open Library?

The following are considered valid “books” in the context of Open Library. Each format should be considered a distinct edition.

Print formats:

Audiobooks:

Please do not add recordings of plays or radio broadcasts unless they include the full text of the written work.

Electronic formats:

The following should not be added to the Open Library database:

The presence of an ISBN does not indicate the item is a valid book.

Top

Can I edit any page on Open Library?

Yes, that's the idea. You're certainly welcome to edit any record you see (author, edition, book), and we encourage you to! There, however, are some pages that we prefer to restrict editing on, such as the site's home page or someone else's profile page. The basic rule is, if you see an edit button on a page, you can edit it!

Top

How do I edit a book record?

Simply head for the page you'd like to edit and click on the "Edit" button on the right-hand corner of every book page. There you'll see a way to add specific information about a particular edition of that book (publisher info, pagination, identifiers from other systems).

If you would like to edit details about the work, just click the tab that says "Work Details". There you'll see a page that asks for general information about the book (a description, subjects aka tags, and useful web resources). Please note that any information added here should be applicable to all editions of the work.

Physical Object

Pagination

In library records, pagination consists of the paging pattern (Roman numerals, Arabic numerals, etc.) and a record of the highest number used for each pattern: xii, 356 p. In cases where pagination is continuous across multiple volumes, the page lowest page may be noted, i.e. 300-600p.

Optional: Unnumbered sequences may included by noting the unnumbered page count in square brackets. Example
Example of pagination

Top

What is the difference between a "work" and an "edition"?

Work and edition are both bibliographic terms for referring to a book. A "work" is the top-level of a book's Open Library record. An "edition" is each different version of that book over time. So, Huckleberry Finn is a work, but a Spanish translation of it published in 1934 is one edition of that work. We aspire to have one work record for every book and then, listed under it, many edition records of that work. The "work" data should reflect the original language, if that is known. The title of the edition or translation goes into the Title box under "This edition."

Top

Which language should I use when adding metadata?

As mentioned above, the Work title should be according to the Work's original language. The Work's description should also be in the original language, if possible. Tags and links can be in any language, but should be limited to languages the work has been translated into (for example, do not use German words as tags if a book only exists in English and Spanish).

The same applies to Edition records. The Edition's title and other metadata should be in the language of that specific edition. The case of the title should be according to that culture. For example, most English books capitalize each word of a title (excluding articles and conjunctions); French titles, however, typically capitalize the first word only.

Top

Which date should I use as the "publication date"?

The publication date is usually on the title or copyright pages of a book, but dates are sometimes on the jacket or back cover. If there are multiple dates listed use the latest date provided. This is sometimes phrased as "published", "printed", or "copyright." Sometimes the date given is clearly earlier than the printing of that edition. For example, if a movie-tie-in edition is dated twenty years before the movie was released, you may estimate the date according to the movie's release. Put a ? next to the date to indicate that this is an estimated date. It is always useful to include information about this in the comments of your edit.

Dates should be in Extended Date/Time Format (EDTF)

Class EDTF
Year, Month and Day 2017-07-11
Year and Month 2017-07
Year 2017
BCE dates -0032

Approximate dates and ranges

Class EDTF
No known date xxxx
Approximate date 1973?
Missing digit 197X
Year range, both years known 2014/2017
Year range, one date known and one approximate 1923/1926?
Year range, both dates approximate 192X/1933?
Year range, one date unknown, one known /1933
BCE date range -0400/-0372
BCE to CE date range -0032/0041

Top

How should I add derived works, collections, or other special cases?

Works and derivatives

The following should be considered editions of the original work, regardless of format:

The following should be considered derivatives of the original work and should therefore be considered independent works from the originals on which they are based. The author(s) of the derived work should be listed first at work-level. In some cases, such as adaptations, the original author may also be listed. In cases where the author of the derived work is not stated, the copyright holder may be used as the first author.

*These guidelines are based on Family of Works from https://www.loc.gov/cds/downloads/FRBR.PDF, adapted for use on Open Library.*

Anthologies, collections, multi-work volumes

Whenever possible, editions or volumes containing the same collection of works should be considered equal to each other and therefore associated with the same work record. All editions of this example contain the same two novels, but edition titles are not identical. If the edition names vary, use a uniform title for the work record with the contained works in alpha order without the article, i.e. “Novels (title 1 / title 2)” or “Works (title 1 / title 2)”. If all editions use the same title, please use this as the work title and you may include the contained works in parentheses as in this example. Short story collections need only list the contained works if required to differentiate from other collections of the same name.

The same general guidelines apply to multi-author works, however uniform titles are usually not needed. If edition titles vary, you may list the individual works in alpha order as the work title as in this example. All contributors should be listed at the work-level. If the editor(s) are specified, these should be listed first followed by the authors.

How can I add an author?

Author creation is tied to the book creation. As you add a new book, we check to see if we already have a record for the author of the book you're trying to add. If there is no match, we'll create an entry for that new author. See this example from the edit page.

image showing how to select author form a pulldown menu

If the book is authored by one of the Carol Stacks already listed, select her name. If neither of them is the right author choose "Create a new record for Carol Stack"

Once you've created the new book entry, you should be taken to the book's new page, and there you will find a link to the author under the book's title. If you click on that link, you'll see a list of any or all books that author has written and a way to edit that author's page on Open Library.

It is common in the library world to use a "library format" for names, which looks like this: LastName, FirstName or Blyton, Enid. That's a bit of a hangover from physical card catalogs, which were generally sorted in alphabetical order. Since we're online now, and can do a search for either a first name or a last name or both, the need for putting the last name first no longer needed. For this reason, we'd prefer if you enter people's names just as you would speak them, in "natural order." So FirstName LastName, or, Enid Blyton.

Alternative names for authors are really useful too, so if you know variations or nom de plumes for people, please go ahead and add them to the author's page. Variations in different languages are also very useful!

To edit the author of an existing WORK, click the tab that says "Work Details". There you'll see a page that asks for general information about the work, including the author. Please note that any information added here should be applicable to all editions of the work.

Other Contributors

Sometimes an edition will have contributors in addition to the author. In most cases these contributors should be added to the edition and not to the work. However, there are some exceptions as noted below.

Editors

An editor may be added to the work if needed to differentiate between single-author collections or selections. For example, there may be many works called Beauties of Shakespeare that are different from each other. Including the editor at the work-level makes it clear which is which. Example 1 and Example 2.

Illustrators

If a work exists because of the illustrations, the illustrator should be listed at the work-level. If there is text, the author of the text should also be included. Example.

Adapters, Re-tellers

If a work has been adapted or retold, it is considered a unique work, different from the original. The Adapter or Re-teller should be the first author listed at the work-level; the author of the original may also be added at the work-level, but after the adapter(s). Example.

Top

How do I format a new author name?

Making Open Library easy to edit is a high priority, so author names are added as full names and not separated into Firstname Lastname (or Lastname, Firstname) fields.

In many cases the author name and surname are obvious, as in Arturo Vázquez. But in a significant number of cases, they are not:

Please add the author's name in the standard format (be sure to check if the author is already in Open Library) and add as much detail as you have.

Top

How do I add a picture to Open Library?

You can add cover images and author photos to Open Library. When you're looking at a book or author page, you should see a link saying "Add/Manage image". If you click on that, you'll see you can either upload something, or by clicking the Manage tab, you can choose the primary image. You can also delete images on the Manage tab by dragging them into the trash can.

When adding cover images to a book, make sure that you add it to an "edition" page. The search engine pulls images from edition pages. Edition pages have Open Library identifiers that end with an "M" (work pages end with a "W").

Size limit for images is 30 MB.

Guidelines for Book Covers

Covers should be accurate for their associated editions. There's a lot of grey area here, so use your best judgement if the exact conditions below don't always apply.

Edition Covers

For editions in library:

Does the scanned book have its original cover?

If yes, use that or don't change from that if already set. If book had a jacket but is missing from scan, acceptable to upload image of the jacket if you're reasonably sure it's correct for that edition.

If no:

For editions not in library:

Is a cover already present?

Image Quality

The full image should be the book cover only. Product display images or photos of books on a shelf or table, for example, should not be uploaded as a cover image.

Acceptable book cover image:

acceptable book cover image

Unacceptable book cover image:

Unacceptable book cover image

Top

Can I see a list of all the stuff I've edited anywhere?

Yes. A history of everything you have edited is linked from your account page on Open Library. Just click on your username in the top right to see the list.

This is one of the benefits of opening an Open Library account - you can keep track of your edits.

Top

I found duplicate authors. Can they be merged?

We have made the author merge feature librarian-only for the time being. If you see multiple authors that should be combined, please send us an email at the Contact Form.

Instructions For Open Librarians

Merging Authors
Open Library holds catalog records from many different libraries around the world, each of which has similar, yet different, cataloging practices. Some libraries will enter an author name like Lastname, Firstname whereas others will enter them Firstname Lastname. Formal titles (such as Sir, Queen etc.) can inhibit Open Library's ability to spot two variations of an author's name as the same author.

Open Librarians have the ability to join these duplicates together. There's more info on the Open Library blog about merging authors, and you can explore recent author merges too.

Splitting Authors
Sometimes, Open Library thinks that a certain author has written a book or two that was actually written by another author with a similar or identical name. In this case, the books in question need to be split apart. It's a bit fiddly to do this, but it's really useful.

Here's how to split an author:

  1. Find the author that needs to be split. Click the EDIT button.
  2. Add some more information to that author record that will help you identify it later, like a middle initial or a birth/death date. Leave a note about what you've changed and hit SAVE.
  3. Then, from the author's page, pick the book(s) that need to be split off.
  4. Now comes the tricky part. On the book page(s) you've just opened, you'll need to edit the works to point to the other author. Hit EDIT on those work pages.
  5. Find the Author field. Clear the name in it, and re-enter the author you'd like to connect this book to. There's a chance there'll only be one entry for the author (hence the join you're trying to split), so you may need to choose "Create a New Author Record for..." That will create a new author stub, and you can attach the books to that stub.

We know this is a bit complicated, but once you've done it a few times, it's not too bad. The key is to make sure there's some distinct metadata between the two author records so you can tell them apart. Good luck!

Top

I find duplicate editions or works. Can they be merged?

Duplicate records can only be merged by librarians. If you find duplicates, you may contact us to request a merge. Please included links to the records or their IDs.

Top

I have found an edition that is associated with the wrong work. Can I correct this?

This is a feature for Open Librarians only

If you are not a librarian, please send details about the issue via the Report a Problem form.

If you are an Open Library Librarian, you may move the edition to the correct work by using the "What work is this an edition of?" field in the "This Edition" section of the edition edit form. There are two ways to do this:

  1. Type the name of the correct work in the field and select it
  2. Type (or paste) the ID of the correct work and select it

It is helpful to other editors if you leave a note about this when you save your edit.

What if the correct work does not exist?

You may create a work for the edition by using the "What work is this an edition of?" field in the "This Edition" section of the edition edit form. To do this, type a space at the end of the existing Work ID. You will see "-- Move to a new work" at the bottom of the drop-down. Select this and save your changes with a note that you are creating a new work.

move edition UI

Important

The edition will now be associated with the new Work, but you will need to populate the title and author of the Work, otherwise these fields will be blank.

Top

What does "History" mean in the context of Open Library?

Open Library is a wiki designed to allow easy editing and connection between pages. It also allows us to keep a revision history of everything ever written in the system. We call that history.

Essentially, history is a reverse-chronological listing of every edit to a particular page on Open Library. If you click on the history of a page, you'll see a little browser thingy pop up on top of the page that will let you browse through the revision history of a page or record.

Top

How can I create a collection page?

This is currently a librarian-only feature.

  1. If page does not yet exist, create new page by entering https://openlibrary.org/collections/[COLLECTION-NAME]?m=edit
    [COLLECTION-NAME] should be replaced with the name of your collection. Choose wisely. The name you use will be included in the url, you may change the name on the page after it’s been created, but the url will remain unchanged.
  2. Use markdown to add content to the page.
  3. To build a carousel using work IDs, follow this example: {{QueryCarousel(title="[TITLE OF CAROUSEL]", query="key:(/works/OL...W OR /works/OL...W OR /works/OL...W OR /works/OL...W OR /works/OL...W)")}}
    Example page.

Pro tip:
A shortcut that can help get a list of the IDs quickly from a list is:

a. Go to the list page using Chrome
b. Open the developer tools console
c. Run this code:
var seeds = await fetch('https://openlibrary.org/people/[USERNAME]/lists/[LIST-ID]/seeds.json')
.then(r => r.json());
seeds.entries.map(e => e.url).join(' OR ');
d. Copy the list of IDs and paste it into your code.

To build a carousel using a search query, follow these examples:

{{QueryCarousel('title:"summer"', search=True)}}
This will return works with the word “summer” in their titles.
{{QueryCarousel('subject:"summer"', search=True)}}

This will return works with “summer” as a subject tag.
Example page.

By default, carousels will only include works that are in the lending library. To include all works use has_fulltext_only=False

Example query: {{QueryCarousel(title="foo", query="key:(/works/OL73243W OR /works/OL54120W)", has_fulltext_only=False)}}

Top

History

March 23, 2021 Edited by Agent Sapphire how to edit author
March 4, 2021 Edited by Agent Sapphire How to edit work.
March 4, 2021 Edited by Agent Sapphire How to edit work.
March 4, 2021 Edited by Agent Sapphire How to edit work.
November 16, 2010 Created by bookfinch Edited without comment.