Troubleshooting Export Errors

If you’re here, it’s because you’ve had an error exporting your manuscript from Atticus to ePub, PDF, or both. While we are working hard to make sure these errors don’t happen, you may come across an error created by importing or copy and pasting content that can be resolved in just a few steps.

If you’ve received an export error, please work through the steps below:

1. Log out of Atticus and log back in
2. With Atticus open, do a hard refresh 

Performing a hard refresh every time you open Atticus is a great habit to get into. This will ensure that every improvement, update, or tweak made since the last time you refreshed is integrated into your system. 

Windows Chrome Users: Press CTRL + Shift + R
Mac Chrome Users: Press CMD + Shift + R
Safari Users: Press Option + Command + E
Explorer Users: Press CTRL + F5

3. Try exporting again

If you’re still not able to export, identify if any of the following are true for your manuscript:

ePub Only Export Error

You may have a corrupted Custom Theme. If you are using a custom theme, please try exporting with an Atticus pre-generated theme. If that export works, please recreate your custom theme using the exact same settings as the original and try the export again.

Copied and Pasted Content

If you have copied content from another program and pasted it into Atticus, there may be hidden formatting that is interfering with Atticus’ ability to export. The best way to resolve this is to import the original document directly into Atticus or paste the content into Atticus without formatting. 

To paste the content without formatting:

Windows Users: 

  • Press CTRL + A to highlight your entire page/chapter
  • Press CTRL + X to cut the entire page/chapter
  • Press CTRL + SHIFT + V to paste the page/chapter back into place without formatting

Mac Users: 

  • Press CMD + A to highlight your entire page/chapter
  • Press CMD + X to cut the entire page/chapter
  • Press CMD + SHIFT + V to paste the page/chapter back into place without formatting

NOTE: This issue is especially common in front and back matter pages so you might want to start there and try to export again after adjusting each specific chapter.

***This will also remove any bold/italic/hyperlinks/etc. in the text so you will need to add those back in after pasting.

Imported Table of Contents

Atticus automatically generates a Table of Contents (TOC) for you, so having one in your manuscript before you upload it to Atticus is unnecessary. The internal links a TOC creates in a Word document don’t currently translate well to Atticus and can restrict exporting capabilities. 

Try removing your imported TOC and exporting again.

Empty Links

Not all links are created equal. Some programs create them in a way that Atticus has trouble identifying. This is especially true if you have exported your .docx from a third party program such as Pages or Google Docs, because it adds layers to the links that can cause problems with exporting. 

When these links are broken they appear empty and can be tricky to find. The best place to start is to look through all of your known links. When you click on them they will open a popup that shows the hyperlink. If you find a link without a hyperlink, re-enter your link ensuring that the proper ahrefs are used (http:// or https://).

Empty Lists or Subheadings

Sometimes an extra space between content can contain special list or subheading formatting. However, if this space is empty, that creates an export error.

If you have any chapters that contain lists or subheadings, try the following for each:

  • Highlight the entire page/chapter by pressing CMD or CTRL + A.
  • Press CMD or CTRL+ X to cut the entire page/chapter
  • Paste the content back in pressing CMD or CTRL + V

NOTE: This issue is especially common in Also By pages so you might want to start there and try to export again after adjusting each specific chapter.

Still Not Exporting?

If none of these tweaks lead to a successful export for you, please email support@atticus.io

 
Thank you for your patience and support in helping us make Atticus stronger, faster, and better for all users now and in the future!

Last Updated: 07/18/2022

Was this tutorial helpful?