Skip to main content

Books

In order to offer books to customers, you first need to create a book and upload its formats to Miguel. To create a book, simply enter its title. The product code is set later, on each format, in the Code field. Books can be created via the administration or via the API.

Creating a book​

In the left menu, click Books and then Add book.

Books and the Add book button

Fill in Title and press Create. The title does not have to match the product name on the e-shop. You can skip the other fields; you can fill them in later, or they are filled in from the uploaded files.

The Add book dialog

Uploading files​

You must first upload the books to be able to offer them. Files are uploaded to a secure central repository in Miguel. Miguel supports several formats for e-books and audiobooks (see Formats). It is also possible to upload several different formats for one book. For example, EPUB and PDF if you want to offer both simple and graphically complex versions.

On the book's page, click Add new format.

Add new format on the book's page

Press Choose a file, in the Add a format from a file dialog choose an EPUB, a PDF or a ZIP of audio files and press Upload. You create a printed book in the same dialog, in the Create a printed format part. You add a PDF to an existing ebook on the format's page with the Add file button.

The Add new format dialog

The books are validated during the upload. For some formats, validation can take several minutes, depending on the size and complexity of the book and the current workload of Miguel. The EPUB takes the longest to upload (see Formats > EPUB > Validation).

Version Control​

You upload a new version of a file on the format's page with the Upload a new version button. You do not enter a version number. Once Miguel has processed the file, you choose how to use it: New version (readers get a new version) or Replace without a version change. For an audiobook, you check the tracks and chapters before it is saved.

Upload a new version on the format's page

Product code​

The code is set on each format separately: on the book's page, open the format's tab and edit the Code field. It is used to match the format with the product on the e-shop or when communicating via API. It is advisable to use a uniform and comprehensible system. You can set it to any text, number or ISBN.

The Code field on the format's page

In our publishing house, we use the URL slug from the book title, so for the book The 4-Hour Body we use the-4-hour-body(all characters lowercase, no diacritics and hyphen instead of spaces).

  • the allowed characters are a-z, A-Z, 0-9, -, _ and /; anything else (including diacritics, spaces, ., @ and +) is rejected
  • the code is case-insensitive, see below
  • we recommend using a simple, universal and readable format
  • we recommend staying within 50 characters, but the length is not limited

Letter case​

The code is case-insensitive — ABC-1, abc-1 and Abc-1 are all the same code to Miguel. So if your e-shop sends a product code in a different case than the one you entered in Miguel, the book is still matched correctly.

Miguel keeps exactly the spelling you entered and returns it unchanged in both the administration and the API.

It also follows that one account cannot hold two formats whose codes differ only in case — if you already have a format abc-1, you cannot create a second one as ABC-1. Changing the case of an existing format's code (for example abc-1 to ABC-1) is still allowed.