KEPUB or EPUB: which format to put on your Kobo
Put KEPUB on your Kobo. It’s what Readwyn sends by default, and the option on the Sync screen sums it up as “Kobo’s own format: better page numbers and reading statistics. The text stays the same.” It matters most for highlights. The Kobo pins a highlight in a KEPUB to the koboSpan around its sentence, and the Kobo that Readwyn was tested against held only KEPUB books. Readwyn can sync highlights for a plain EPUB too, but no device has confirmed that form yet.
What the conversion does to a book
Not a word of the text changes. On the way to the Kobo, Readwyn wraps every sentence of every chapter in <span class="koboSpan" id="kobo.<paragraph>.<sentence>"> and adds two wrapper elements around each chapter’s content. The copy on the Kobo is Books/<first author> - <title>.kepub.epub, and the EPUB in your library stays exactly as it was. So a highlight points to the same text in the KEPUB on the Kobo as in the EPUB in your library.
How highlights are placed
In a KEPUB, the Kobo records a highlight as a sentence span plus an offset into it. Readwyn reads that position when it brings highlights in, and checks that the text at the spot matches the highlight exactly. When it does, the highlight gets its place in your EPUB, and with it a page and the passage around it. Going the other way, Readwyn writes a library highlight as a span and an offset. A highlight written from the Mac into a copy of that Kobo’s database came out in exactly the same form as the rows the Kobo writes itself.
A plain EPUB is different. There the Kobo stores the position as a point(...) path, the same kind of path that EPUB CFI uses. Readwyn writes that form and reads it back, and round-trip tests pass, but the format comes from a public report of the Kobo’s rows rather than from a device Readwyn has checked.
Where to switch it
There’s one setting for all your Kobos, and one for each Kobo:
- Settings › E-readers › “Sending books”: “Convert EPUB to KEPUB for Kobo e-readers”. It’s on by default and applies to every Kobo that has no setting of its own.
- The Sync screen › “Options for this device”: “Convert EPUB to KEPUB when sending”, for the Kobo that’s plugged in.

With it off, Readwyn copies the EPUB across unchanged, as Books/<first author> - <title>.epub (sending a book covers the rest). The option has no effect on comics, which always go as CBZ, a format the Kobo opens itself.
EPUB 2, EPUB 3, and books already on the Kobo
A book in your library can hold two EPUBs: an EPUB 2 original and the EPUB 3 that Readwyn converted from it. “Send to device” sends the EPUB 3, as a KEPUB if the option is on.
A KEPUB that’s already on your Kobo may have been made from either. During a sync, Readwyn checks whether each KEPUB on the Kobo was made from an EPUB 2 or an EPUB 3, and maps highlight positions through the library file of that version. It never rewrites a KEPUB on the Kobo to make the positions fit.