Help & FAQ
Answers to the most common questions about using AccesPub.
Workflow
What steps do I follow to remediate an EPUB?
Upload your EPUB on the home page. AccesPub will analyse it and apply all automatic fixes. Then review the report: check images that need alt text, verify tables, and address any manual issues. Finally, go to Export to download the accessible EPUB together with its conformance report.
Images & alt text
What is alt text and why does it matter?
Alt text (alternative text) is a short description of an image. It is read aloud by screen readers for users who are blind or have low vision. Without it, images are invisible to those users. WCAG 2.2 requires alt text for all meaningful images.
When should I mark an image as decorative?
Mark an image as decorative when it adds no information — for example, a purely ornamental divider, a background texture, or a repeated logo. AccesPub will set an empty alt="" so screen readers skip it correctly.
How does the AI-generated alt text work?
When you ask for a suggestion, AccesPub sends Google Gemini (paid API) the image, the text around it in the book (at most about 300 characters before and 300 after, or its caption) and the language it must be written in, and receives a suggested description. The AI only sees that excerpt, not the whole book. This suggestion is shown as a starting point — always review it before saving, as AI can make mistakes, especially with charts, diagrams, or text-heavy images.
EPUB & accessibility standards
Which accessibility standard does AccesPub target?
AccesPub aims for EPUB Accessibility 1.1 at WCAG 2.2 Level AA. WCAG 2.2 is the version used by EN 301 549 v4.1.1, the European standard for the European Accessibility Act (EAA); content that meets WCAG 2.2 AA also meets WCAG 2.1 AA.
What is EPUBCheck and why does it matter?
EPUBCheck is the official IDPF/W3C validator for EPUB files. AccesPub runs it automatically after remediation. Passing EPUBCheck with zero errors is a prerequisite for declaring EPUB Accessibility conformance. Warnings are advisories that you should review but do not block conformance.
Why can't AccesPub process Fixed Layout EPUBs?
Fixed Layout EPUBs are designed as pixel-perfect replicas of printed pages. The format is inherently inaccessible because content cannot reflow or adapt to user needs (font size, screen size, assistive technology). The EPUB Accessibility standard does not cover Fixed Layout. Please use reflowable EPUBs instead.
Correction report
What is the correction report?
The report is an HTML document you can download from the Export screen. It details every change AccesPub made to your EPUB: automatic fixes applied, accessibility metadata added, images and tables reviewed. It is an informational document about the remediation process, not an official conformance certificate.
What does the EPUBCheck result mean?
EPUBCheck is the official W3C/IDPF validator for EPUB files. AccesPub runs it automatically after remediation. Zero errors means the file is structurally valid — a prerequisite for declaring EPUB Accessibility conformance. Warnings are advisories to review but do not block distribution. Errors must be resolved before submitting to any distributor.
ONIX metadata
What is ONIX and what does AccesPub generate?
ONIX (Online Information eXchange) is the international standard for communicating book metadata to distributors and retailers. AccesPub generates an ONIX 3.1 file (onix.xml) that includes accessibility codes (EPUB Accessibility 1.1), descriptive metadata (title, author, language, publisher) and subject classifications. You can download it from the Export screen.
What fields do I need to fill in before sending to a distributor?
At minimum you need a valid ISBN-13 and a publisher name — both required by DILVE and most distribution platforms. You can also add a synopsis, Thema codes, BISAC codes and keywords. Fields marked For distribution in the metadata form are especially important. Without ISBN the distributor cannot link the file to any existing product record.
What does the AI enrichment do?
If a Google Gemini API key is configured, AccesPub can analyse the text of the EPUB and suggest an extended synopsis, relevant keywords and Thema subject codes. Suggestions are shown for review before applying — always check them, as AI can misread genre, tone or niche classifications.
What is NOT included in the generated ONIX?
Price, territory, availability and supply conditions (SupplyDetail) are not included — these commercial fields depend on each distribution agreement and must be added in your distribution platform. The generated ONIX is a starting point, not a complete commercial feed.
Credits & limits
What is a credit?
One credit equals one remediated EPUB. It is deducted the first time you download the corrected EPUB. Uploading, analysing and reviewing do not use credits, and downloading it again from the same session does not either.
Is there a file size limit?
Yes, AccesPub accepts files up to 50 MB. If your EPUB is larger, contact us by email and we will find an alternative way to process it.
Contact
How can I get support or report a problem?
Email us at info@abserveis.net. Include the name of the EPUB and a description of the issue. If you can share the file, that will help us investigate faster.