Open main menu
Status last updated 19 August 2019.

How to report issues How to escalate issues
  • please check whether this issue is already known
  • provide a link to an article that is affected by the issue
  • report only one issue per section
  • select a descriptive title
  • consider prefixing the title with Bug, Proposal, Question, Comment, Task ...
  • remember to sign your post with ~~~~
  • consider warning readers of the problem by placing |bug=... in the {{saved book}} template of relevant books

There is a central page at gathering all major issues with this extension. Issues that can't be solved and are not yet covered on the page at meta should be added there.

For obvious bugs the issue tracker is the preferred place to directly issue and check tickets.

At IRC #pediapress some immediate support might be available.

Book SplittingEdit

Wikipedia clearly warns new editors that the Book Creator does not support large books with more than 500 pages. However, an alternative option is to fork a book just prior to the 500 page limit, by saving it under a unique title (or revision), prior to proceeding to adding more pages and subsequent topics, although later saves of the book may fail. Again, as already indicated, this method is highly likely to error out for many users and is not recommended. This is not a problem with technology, it is a problem with editorship.

For instance, most users cannot plan their book out in advance, such that each saved volume contains 500 or fewer pages (give or take), because most books grow in an utterly random fashion similar to the Bell Curve of a pile of dung dripping from a cave ceiling, but with a tail that skews to the right. In other words, book size (as number of pages) grows non-linearly as a function of numerous random variables, including the grow of semantic topics included in the book. Perhaps the correlation closest to a linear relationship is the growth RATE in pages, against the growth rate of topical scope, although this would be difficult to operationalize. Thus, central topics fill more pages added, in early-stage book growth, with topical scope widening at a fast rate, then narrowing again at a slower rate (of pages added per change in scope). Additionally, more fringe topics tend to fill in gaps between central topics, at a nearly steady rate per click throughout the process of book creation, but represent very nearly the only added pages, near the final stages of book creation.

It is significant to note here that most users [whether planned or not] alphabetically organize their books, as a last step before saving them, although almost half of all books do not get saved permanently, and another smaller percentage of books never even get saved. This is theorized to represent compensation for lack of organization of the book. However, a much better method for compensating for lack of organization, is to actually organize the book, which might require segmentation into more manageable chapters and volumes first. Thus, for a typical non-linear, poorly planned, and unpredictable 'non-central growth' model and given the likelihood that few pages will be deleted from most created books, either as drafts or in a final pruning or quality control stage, editors can save lower quality final works as multiple volumes instead of higher quality single volumes, and still retain the option of future refinement, without any immediate compromise in total pages included.

The best approach to content splitting (for the average editor) is to save a work-in-progress multiple times (under 2 titles), and then delete pages from each volume accordingly, prior to adding pages to each volume. By such a method therefore, a multi-volume book might grow indefinitely through iterative splits. For example, at 500 pages, one could save one's book with the title "Big:Volume 1", and then immediately save exactly the same book again as "Big:Volume 2" (still, with exactly the same 500 pages). Next, the user would delete pages 250-500 from Volume 1, and delete pages 1-250 of Volume 2. Then the user could proceed (once again) with the task of randomly surfing and "filling in" their book with accidentally discovered candidate pages for each of the two volumes (technically, now two separate books), via the navigation patterns of click-through behavior documented by web analytic research. Of course, an even superior method (albeit unlikely) would simply be to plan one's editorial work out in advance, in terms of topical coverage, order, audience, goals, etc., and use an iterative PAGE-DELETION methodology with at least two drafts, thus excluding less critical pages and creating a final piece of higher value.

Can't find the way to include pages from different languages in one bookEdit

(I'm sorry if this should be reported elsewhere but I couldn't find this information neither in FAQ nor in Help pages). I'd like to include Wikipedia pages from different languages to single book, but it seems that Book creator is always initialized independently for each language and pages are added independently as well - does it mean that there is no way to combine such pages? Maybe it's worth to include the answer to the FAQ. Thanks.

Non 0 exit code after progress reaches 100%Edit

It is almost November 2015 and when I click in "Download as a PDF" on the following article, I got "Status: Rendering process died with non zero code: 1". — Preceding unsigned comment added by (talk) 19:45, 28 October 2015 (UTC)

It would be nice if someone would create a response to this problem, like the one I see when my browser fails, "Well this is embarrassing . . . ," because it is. I've been ur for 24 hours trying to do something I've done frequently, but now cannot do to save my life. Say what? How dumb is this? Very! I'm sure I won't get a response, so I take it, it doesn't matter what I say here. Dissatisfied user, Kkhemet (talk) 18:26, 14 September 2015 (UTC)

Well, just to make this section as complete as the Wikipedia itself (!) : This bug is still present today (Aug 2015). — Preceding unsigned comment added by Vbbhasti (talkcontribs) 18:04, 17 August 2015 (UTC)

I am trying to create a copy of this book ( I tried 3 times but the result is the same. After the progress reaches almost 100% the process fails with a non zero exit code.

May I know whether I can do something? Thanks. Sarmadys (talk) 20:07, 13 October 2014 (UTC)

I have been trying to download a book that I compiled and every time I try to download, when it reaches 100%, this pops- up "Generation of document file has failed. STATUS: Rendering the process died with non zero code: 1". I have tried this over a few times and the results are still the same. I hope this problem can be solved in the near future. (talk) 12:31, 17 December 2014 (UTC) Maue Zamora

I am having the same error, progress reaches almost 100% then fails with: "Rendering failed \ Generation of the document file has failed. \ Status: Rendering process died with non zero code: 1". — Preceding unsigned comment added by (talk) 03:58, 21 December 2014 (UTC)

There are more of us experiencing the same issue is there a size limit if so please let us know. — Preceding unsigned comment added by Rjdrescher (talkcontribs) 20:30, 7 January 2015 (UTC)

Same problem: Rendering failed Generation of the document file has failed. Status: Rendering process died with non zero code: 1 Return to Book:Machine Learning – The Complete Guide — Preceding unsigned comment added by (talk) 17:48, 7 April 2015 (UTC)

I have the problem with the code "Rendering process died with non zero code: 1"
The link of the book is ""
It is a more complex book with 20 chapters divided into 3 main sections. The error code appears after completion massage "100%". Thanks for response.

Kind regards Michaelt1964 (talk) 11:21, 11 January 2015 (UTC)

I am having the same problem with "Rendering process died with non zero code: 1" after completion of 100% of rendering of a book to pdf. the book has about 40 articles/wikipedia pages and i made a table of contents with about 6 chapter headings. Some of the chapters have tables in them, (e.g. wikipedia articles in English on "Plant", "Green_algae", and "Bryophyte"). I've tried changing paper size (A4/letter), changing table of contents settings (auto, on, off), and changing columns (1, 2) but alway get same failure to render to pdf with above message. Thank you for any assistance. Here is the book saved on my wikipedia page: best wishes, Tim. Jan 16, 2015 "SinkingCreek" — Preceding unsigned comment added by SinkingCreek (talkcontribs) 00:02, 17 January 2015 (UTC)

HOW TO FIX ??? Same rendering error - Rendering process died with non zero code: 1. Most likely a heap size issue or generation issue on incompatible content. Why can't we get the detail errors listed as an option instead of the return code?

If this is a free service, why can't we get error feedback in the browser so we can edit or split the book to resolve the issue?

I don't think this is because your files are too big (although I suppose it could be), because this exact same thing is happening to mine, too, and it's just 14 articles, several of which aren't even that long. I just took each article found at and re-compiled it into a collection in the order of the book table of contents listed there. I wish some people would fix this issue as it seems to stretch at least as far back as 2014 October, or at least that's the timestamp for the first bug report shown here. — Preceding unsigned comment added by SarahTehCat (talkcontribs) 00:31, 12 March 2015 (UTC)

I'm having the same problem in April 2015. I'm not sure these Help pages are being monitored by anyone who can fix this problem. Pulamusic (talk) 13:54, 8 April 2015 (UTC)

This problem is persisting through late April 2015. Hopefully it'll get fixed, but looking at the history here, I doubt it. Harnessedsea (harnessedsea) 19 April 2015 — Preceding undated comment added 15:40, 18 April 2015 (UTC) I am getting the same error for almost third of the Wikipedia books I tried to download (computer science books) and the ones I tried to create (complexity problems and unsolved problems in computer science). Most of the times it happens both at size A4 and Letter. Sometimes it fails for one size but succeeds for the other. I prefer letter paper size (Canada) but sometimes I only was able to generate A4 and most times neither. These are the Wikipedia books listed under category computer science and also those under computational problems. This bug is marked as low. It should be raised to high. This is Apr 27 2015. — Preceding unsigned comment added by (talk) 17:43, 27 April 2015 (UTC)

It is June 16, 2015, and the problem continues ( I attempt to save as PDF and get this error message:
→ Rendering failed.
→ Generation of the document file has failed.
→ Status: Rendering process died with non zero code: 1.
Well, yeah, I noticed. It's a simple book: 36 pages. Have tried adding/deleting articles, saving the book with a new name. The rendering process continues dying. Umpteen different "help" documents on Wikipedia about creating, saving, printing books; no answers in any of them. Have looked for answers on non-Wikipedia sites, without success. Does anyone at Wikipedia even care about this bug? It's like talking to air… Username: folder1 / Real name: Peter F 22:16, 16 June 2015 (UTC)

It's my opinion that Wikipedia ceased to be a vibrant community of responsive editors years ago, when the tide turned towards Deletionist trolls, and every article had to be defended against ad hoc standards of notability. Since then, the enormous body of knowledge we created in the early years has been degraded, becoming less and less usable. That's why I stopped editing. Ok, climbing down off my soap box. Yes, I'm having the same problem generating a book. Nathan McKnight -- Aelffin (talk) 20:39, 9 August 2015 (UTC)

I am having a similar problem and can't seem to find a solution to my problem anywhere, which is, attempting to download book as a PDF, during rendering it stops at progress: 36.67% status: creating attribution page (wiki page: enwiki:[Parsoid]) and it freezes here. I try refreshing the page as is suggested and it only reloads to exactly the same page in the same spot. I am not able to progress any further. I tried the back button numerous times and each time the rendering stops/freezes in the exact same place every time. I would really like to download my book could anyone please help me with this problem??? CuriouslySeeking (talk) 16:38, 30 June 2015 (UTC)

I have a temporal, but unsatisfying solution: Save your book and try edit the pages with page creator. Just delete some of the pages, each for each (be sure you saved it before) and try to render it. After you delete the page which produces the error (? such like "messiah" in my case) you're able to render and download it - without this page. Hope it helps. Lugsciath~enwiki (talk) 11:00, 29 September 2015 (UTC)

Same error, "Status: Rendering process died with non zero code: 1," continues (ref: ). I have tried to render the book a month ago, but the problem is on going. The progress has stopped at the PDF compiling stage. — Preceding unsigned comment added by (talk) 13:31, 26 October 2015 (UTC)

Possible causeEdit

November 25 2015 - I think I might have accidentally discovered the problem. I was creating a pdf on early civilizations and got the same error message as everyone else. After trying a few dozen times, I decided to just download each page as a single pdf and merge them later. Every page worked.

Except one: Babylon.

When I tried to download that page I received this message: "! Package polyglossia Error: The current roman font does not contain the Syriac"

I removed Babylon from my book...and it worked perfectly.

Could THAT be the problem?


This piece of wikitext is causing it: {{lang-syc|ܒܒܠ}} (lang-syc of course indicates Syriac characters, as per the error message). I copied Babylon to a test page and the pdf failed with the same message. Then I clipped the offending code and the pdf worked just fine. So it looks like you are on to something. Cool! and Thank you!! All we need now is a coding expert willing to work for free.... — Cheers, Steelpillow (Talk) 22:22, 25 November 2015 (UTC)

Yeah I think that's it! I tried to download a book about the world's largest companies and I failed. I then removed all of the Chinese Companies and it succeeded!- York12321 (Talk) 11:15, 75 November 2015 (UTC)

You are right as it seems problem is actually linked to some specific code in some specific page. I experienced same issue with French Wiki page on Plasence town when compiling a book on Estremadura. I am not experienced enough to make some accurate testing but there is no such alphabet issue there. — Preceding unsigned comment added by 2A01:CB00:67F:8600:B422:DE64:CE64:3F75 (talk) 18:58, 14 February 2016 (UTC)

That seems to be it. I was having the same problem--about 22 articles, 300 pages. I tried it one-column and two-column. It failed both times, though I was able to download it in text format. Two of my articles dealt with Chinese biographies--one of Chiang Kai-shek and the other of Mao Zedong. I removed the two, reran the program, and it compiled properly. Thanks greatly to those above for suggesting the correct solution.

Another similar problem I recently found was down to broken HTML code in the page, where it contained <em>something<em>, creating two open em containers, instead of <em>something</em> which closes off correctly. The best thing is to copy the page to your sandbox bit by bit, clicking the "Download to PDF" link each time to see where it crashes. Then take a close look at that piece of wikitext. — Cheers, Steelpillow (Talk) 19:30, 14 February 2016 (UTC)

February, 19th 2016: I've had the same problems and it worked when I selected 2 columns instead of one. — Preceding unsigned comment added by (talk) 12:38, 19 February 2016 (UTC) also fails due to this code File:LavabitCourtDocuments.pdf I am trying to figure out how to fix this but it seems like good HTML code. You will have to look at the source of wikipedia's article on Lavabit to see what I mean. Any thoughts? Josiah.k.powell (talk) 12:31, 24 August 2016 (UTC)

Is it Time to create a code bounty using Bountysource? Where does Wikimedia take direct funding for fixing specific issues?Unfortunately, phabricator wikimedia's bug reporting tool is NOT supported on bountysource as yet Long story short, if we want something, we'll have to pay developers/coders to fix this issue.DennisDaniels (talk) 14:03, 27 August 2016 (UTC)

I was told about Wikipedia Books years ago. I've been trying it for the last couple of days, and it still can't do the only thing it's supposed to do. — Preceding unsigned comment added by (talk) 23:42, 5 November 2016 (UTC)

The Book Tool No Longer Appears Above Article PagesEdit

I recently discovered the Book tool a few days ago, and after I enabled it, the interface tool appeared above all of the articles. However, due to time constraints, I elected to save creating a book for later. Now, I went back to try to create a book, and the interface box no longer appears above articles. I am still able to add links directly to the book when I mouse over them, but without the interface box, I am unable to look at, organize, or purchase any book I make. Is this an issue that other people are having, and if so, how can I fix it? Jionunez (talk) 00:53, 23 October 2016 (UTC)

@Jionunez: It works for me. Does Special:Book work for you? PrimeHunter (talk) 01:49, 23 October 2016 (UTC)
@PrimeHunter: Yeah, that page works, thanks. It's still annoying that the box still doesn't show up, but at least I can work on the book. Thanks! Jionunez (talk) 02:44, 23 October 2016 (UTC)
@Jionunez: You probably clicked "[hide]" to the right of the tool above the article. You should be able to get it back by deleting a cookie in your browser. The method depends on the browser. See e.g. Delete the cookie "dismissSiteNotice" for You can also delete all your cookies or all your browsing data but this may have many other effects on the websites you use. Or you can use another browser where you haven't clicked "[hide]". If you want to keep a book you are working on then save it first. PrimeHunter (talk) 10:44, 23 October 2016 (UTC)
@PrimeHunter: Thanks, that fixed it! Seems like more of a hassle than is should be to get it back, but its back now. Jionunez (talk) 23:36, 23 October 2016 (UTC)
I agree it's complicated. It took me some time to work out and I haven't found an easier method than deleting the cookie. I'm a volunteer editor and not a developer. PrimeHunter (talk) 23:54, 23 October 2016 (UTC)

@Jionunez and PrimeHunter: I had the same problem, and I (finally) stumbled upon this thread. The solution worked for me too! Seriously, though. They should make it way easier than how it is now, or if not, at least make it easy to find this info. It was very frustrating to hunt for info. It is a serious issue in my opinion.--Mr. Guye (talk) 02:11, 1 May 2017 (UTC)

I have added a section at Help:Books/for experts#Hide and unhide book creator. PrimeHunter (talk) 23:33, 9 May 2017 (UTC)

Is there no way to create a button somewhere on top of the page for unhiding the Book Creator Interface instead of it disappearing completely when we click on "Hide" button? Simply clicking on the "Unhide" button would save a whole lot of time that we spend (Half of the whole day in my case, before I found this thread) on trying to get it back. I wouldn't have dared to hide it at all if I knew how not easy it is to see it again.--HakimBalogun (talk) 14:43, 24 August 2017 (UTC)

HakimBalogun: Unfortunately there has been little or no work on the tool for years. I have added this to Help:Books#Step 1: Enable the "Book Creator" tool so it's easier to find: "If you have hidden the book creator then see Help:Books/for experts#Hide and unhide book creator." PrimeHunter (talk) 14:52, 24 August 2017 (UTC)
@PrimeHunter: Good job for this option. I'm really glad your idea shows me what to do next time. Thanks! -- HakimBalogun (talk) 15:46, 24 August 2017 (UTC)

Content in wikitables will not renderEdit

As an experiment, I created a book about Lecrae, and the content part turned out fine. However, anything in a wikitable, such as his filmography, discography, and awards, will not render at all, leaving many sections blank. Is this a known issue?--3family6 (Talk to me | See what I have done) 06:18, 24 November 2016 (UTC)

@3family6: Yes; see the warning box at the top of Help:Books. -- John of Reading (talk) 07:00, 24 November 2016 (UTC)

Filed as issue . --Wikinaut (talk) 01:36, 14 January 2017 (UTC)

Draft namespaceEdit

It seems like this tool was never enabled in the draft namespace. Is there any reason it shouldn't be, and barring any, could it be enabled? --AntiCompositeNumber (Leave a message) 23:28, 5 December 2016 (UTC)

Drafts are by their nature below publishable quality. Why would we want to make unpublishable-quality books? Better to get the pages published first and then tweak them for better book rendering. — Cheers, Steelpillow (Talk) 10:36, 6 December 2016 (UTC)

Where are my booksEdit

Every time I go to WP to open my books, I have trouble trying to find back the books I created. I would expect to return me that list. Instead, I have to open a book, then look for the Save link, from which I deduce that I can find my list at This is so annoying... — Preceding unsigned comment added by Axd (talkcontribs) 09:33, 7 May 2017 (UTC)

That is in part because you have not created User:Axd/Books. Open it from the link I just gave and add the content {{list subpages}} (note the curly brackets) before saving to create it. This will list them all. — Cheers, Steelpillow (Talk) 12:36, 7 May 2017 (UTC)

seems to work, thanks alex (talk) 13:48, 7 May 2017 (UTC)

Here is a way to find all your subpages, both saved books and anything else (you only have books): Click "Contributions" at top of any page and then "Subpages" at the bottom. PrimeHunter (talk) 14:54, 7 May 2017 (UTC)
Or, for a permanent display, create a section for them on your user page and add the above list subpages code to it. — Cheers, Steelpillow (Talk) 16:34, 7 May 2017 (UTC)

Wikibooks make no senseEdit

I sort of have an issue with the very concept of a print wikipedia book. A wikipedia article is a living document, it has its history and goes through edits, and quite frankly thats what separates wikipedia from other 'official' encyclopedias. Much good material is rejected, but atleast it sort of lives on in the history. A book on the other hand is not living, it is a dead document, a snapshot of a particular moment in time, and does not carry its history with it. I realize wikimedia tries to be a jack of all trades, but I find support of books regressive and going against everything wikipedia exists for. Not to mention, poor trees. Doseiai2 (talk) 06:21, 8 May 2017 (UTC)

This is the wrong place for such a discussion. (I might just comment that most books, whether printed or electronic, have a surprisingly short shelf-life. For example educational resources also update regularly and a Wikibook is a great way of ensuring that the latest intake of students get the latest snapshot of knowledge, without having to prepare new editions every semester.) — Cheers, Steelpillow (Talk) 07:40, 8 May 2017 (UTC)

BUG: Code Blocks do not Render Correctly in BooksEdit

While creating PDF books for articles which contain code blocks (such as Shunting-yard algorithm and Operator-precedence parser), the code blocks get rendered as normal paragraphs, with all the lines running through. While this may not necessarily be a problem for C-style languages which have well-defined statement termination characters, it really is a problem for other languages (and even pseudo-code as is quite common on many Wikipeda pages).

One thing I realised in addition was that the code blocks render correctly when a page is saved as a single-column PDF but the same error I described above appears when changed to a two-column PDF format. This leads me to believe that the same renderer being used for two-column PDFs is being used for the books as well.

Alex Essilfie (talk) 10:49, 27 June 2017 (UTC)

@Alex Essilfie: Your assessment is correct. The renderer for books is also used by the 2 column PDF, and this renderer doesn't support many of the options. The single column PDF is an expiriment to replace the PDF renderer with something different that would work a little better. These are known problems, but the support for Books has not really been developed any further since 2012 and it is unknown when this might be picked up again. —TheDJ (talkcontribs) 13:49, 27 June 2017 (UTC)

How do I get rid of annoying hover link?Edit

Every time I hover my mouse over a link, anywhere in Wikipedia, an annoying and very intrusive tab opens up saying "add link to book" or whatnot. I want that to go away. Forever. How do I do that? Do I need to delete my book just to do that? I hope not, but I'll do that just to make it fuck off disappear. --Pericles of AthensTalk 17:59, 1 August 2017 (UTC)

Do you have a Book Creator box appear at the top of every page? If you do, then click (disable) next to its title. — Cheers, Steelpillow (Talk) 19:24, 1 August 2017 (UTC)
@Steelpillow: yeah, about that. I would love to do what you're suggesting, but now I can't. In my frustration, I clicked the "hide" button, and now I don't know how to make the box reappear! I went back to the "Manage Your Book" page and there doesn't seem to be any way to reverse this decision, from what I can tell. Pericles of AthensTalk 19:32, 1 August 2017 (UTC)
@PericlesofAthens: Apparently you can un-dismiss it by deleting a cookie: Help:Books/for experts#Hide and unhide book creator -- John of Reading (talk) 19:47, 1 August 2017 (UTC)
According to Help:Books/for_experts#Hide_and_unhide_book_creator, you have to disable/delete a particular cookie in your web browser and Book Creator will reappear. — Cheers, Steelpillow (Talk) 19:49, 1 August 2017 (UTC)
It worked! Thanks for the help. That being said, you guys might want to make the hide/unhide option a bit easier to manage than having to track down cookies and delete them in your browser settings. Pericles of AthensTalk 20:17, 1 August 2017 (UTC)

Contredicting info about OpenDocument availabilityEdit

This page Help:Books/FAQ claims that:

"What happened to OpenDocument Text and openZIM export?

These options are no longer available."

But this page Help:Books/for experts still refers to OpenDocument.

"The most efficient way to identify problems is to go on the individual articles of your book and view the article as a PDF (click "Download as PDF" in the "print/export" box on the left hand side of your screen, towards the bottom). Preview the page, and if something doesn't look right, chances are there's a problem. While the printed books and OpenDocument version will differ from the PDF version, they share a lot of similarities. If something looks weird in the PDF version, chances are it will also look weird in the printed book or OpenDocument version."

So I am asking. Is OpenDocument still a valid option or should it be removed from that help page? ויקיטכני (talk) 13:59, 2 May 2018 (UTC)

Removed. — Cheers, Steelpillow (Talk) 09:58, 18 June 2019 (UTC)

Error loading book ordersEdit

Three days in a row I try to order the book Clássicos do Fluminense Football Club (Wikipedia in Portuguese), in PediaPress, and at the end of the loading attempt a message "Some error occurred when your collection of articles was prepared and sent." If it is not possible to solve this problem with Wikipedia resources, it may be worth hiring an external expert, since Wikipedia is losing money because I imagine that it is happening in all cases of shopping attempts.

For years the option of downloading books in PDF is having problems.

Att, Alexandre M. B. Berwanger (talk) 21:04, 17 June 2019 (UTC)

Hi. First, PediaPress is an independent company. The Wikimedia Foundation and Wikipedia make no money from its sales. Nor can we help with its problems, you should contact PediaPress directly through the details given on their web site.
But there is something you can do here. The best way to diagnose this is to take each article in turn, create a book from it alone, and then upload that book. Most of these one-article books will build OK, perhaps one or two will fail. So you will then find out which articles have a problem. If an article is complex you can then copy it to your user space and edit out anything suspicious until it works. Things to look for:
  • Bad wikitext code in the page. You can fix this yourself.
  • Bad code in a template. You can usually identify the template, but may need help from our community to fix it.
  • An obscure language font in the article, that is missing from the PediaPress server. You can tell PediaPress and ask them to install it.
Hope this helps. — Cheers, Steelpillow (Talk) 08:28, 18 June 2019 (UTC)
Many thanks for the guidance! Cheers, Alexandre M. B. Berwanger (talk) 10:35, 18 June 2019 (UTC)