## Problems with Opening Scribus Files

### Damaged Files

#### Parsing Errors

One of the major reasons for a damaged file (any file, not just Scribus files) is an interrupted saving procedure, e.g. a power failure or a system crash while the program was writing the data to the storage medium (like a hard drive or a USB stick). Other reasons can be file system errors or a damaged storage medium. Since Scribus SLA (and the older SCD) files are Plain Text XML-based files, these files can also be damaged by users themselves if they open and edit the files in a text editor.

No matter what the reason for a damage to a particular file may be, the result will be that Scribus can’t “parse” (i.e., in very general terms, read and interpret) the file’s content, e.g. due to missing XML tags or invalid data. In such a case, Scribus will display a warning that indicates the line number of the file in which it stumbled across the error:

To fix damaged SLA and SCD files, a simple text editor is sufficient. For practical reasons, however, it’s recommended that the text editor provide a little more features than, for instance, Notepad on Windows. At the very least, the text editor should be able to show line numbers and support XML syntax highlighting. In case you are unfamiliar with XML concepts like tags etc., you can file a bug report and upload the damaged file to the bugtracker. In general, you can expect the file to be fixed by the developers within 48 hours. Be aware, though, that fixing a file by the developers need not mean that all content can be restored, as not all of it may have been written to the storage medium before the error occurred. Thus, repairing a file may only result in a file that can be opened by Scribus again.

#### Other File Errors

While it’s relatively easy to repair SLA and SCD files, things are more complicated if you’ve been saving a compressed version (SLA.GZ or SCD.GZ). In such a case you will have to use a tool that can either repair a damaged gzip archive or, if the latter is impossible, retrieve as much of the archive’s content as possible.

### Documents Created with Another Version of Scribus

#### Files Created with an Earlier Version of Scribus

When you open a file created with an earlier version of Scribus, you will see a warning that you may or may not want to ignore. You can ignore it if you are sure that the file won’t have to be opened in an earlier version again, e.g. if you created the file yourself and simply upgraded to a newer Scribus version. If you’re working in a team, you should always make sure that all team members use the same version of Scribus.

But what if you ignored the warning or saved the file inadvertently, knowing that your partner has to or wants to use an earlier version? Saving back to an older file format version isn’t possible. What you can do in such a case is to group all items on every page and then copy each group to the Scrapbook, page by page. You can then send your Scrapbook to the person that uses the older version, because the Scrapbook format didn’t change between versions. Be aware, though, that linked text frames on different pages cannot be re-created this way: You’ll have to re-link them in the earlier version.

While every newer version of Scribus can open files created in older versions, including SCD and SCD.GZ files saved by early 0.x versions from more than a decade ago, you should always check the text layout, because the Scribus text layout algorithms have changed significantly over time. This measure of caution is especially important with older file versions, but it is recommended to always check the text layout if you open the file on another computer or after a font upgrade. While Scribus always does a font check during startup, it does not check for different font versions when it opens a file. Thus, different font versions or fonts with the same PostScript font name, but from different vendors/sources may result in broken text layout, e.g. unintended text overflow.

A special note about files created with Scribus versions 1.3.5 to 1.4 Release Candidate 5: An important fix to the text layout engine in Scribus 1.4 Release Candidate 6 may cause significant text layout changes in text frames with certain text layout features (e.g. First Line Offset) applied, so re-formatting of text may be necessary in files created in versions prior to 1.4RC6.

#### Files Created with a Later Version of Scribus or Non-Scribus Files

Files created in later versions of Scribus cannot be opened by earlier ones. This is even true when both versions use the same file format, e.g. 1.3.9 and 1.4.0. Trying to open a file created in a later version with an earlier one will result in the following warning. This warning will also be displayed if you open a SLA, SLA.GZ, SCD or SCD.GZ file that is no Scribus file at all (there may be other programs that use these file extensions). The same goes, of course, for other file formats that can be opened by Scribus directly.

If you, for one reason or the other, can’t use the latest stable release of Scribus, and your version supports the same file format, you can open the SLA file in a text editor and replace the Scribus version in the file header:

Example:

`<?xml version="1.0" encoding="UTF-8"?>
<SCRIBUSUTF8NEW Version="1.4.0">`

can be changed to:

`<?xml version="1.0" encoding="UTF-8"?>
<SCRIBUSUTF8NEW Version="1.3.9">`

Be aware, though, that you do so at your own risk, especially if you consider the changes made to the text layout engine since 1.4RC6.

### Safety Measures

It may sound like a platitude, but every program and every operating system can crash, which means you may lose some or all of your work. Likewise, no computer is expected to run flawlessly forever and, like all material things, will cease working one day. Thus, the timeless hint “save your file regularly” also applies to Scribus. Fortunately, Scribus allows for automating the saving procedure to let you concentrate on your layout.

#### Autosave

To let Scribus save your results in regular intervals, you can activate “Autosave” and set the interval in the Document section of the Document Setup/Preferences. In addition to automatically saving your Scribus document, Scribus also creates a copy of the document. The copy’s file name consists of the original file name extended by the extension “.autosave”. Thus, the “autosave” copy of `myfile.sla` will be stored as `myfile.sla.autosave`. Should a SLA file have been damaged, you can always remove the “.autosave” extension and then open the “autosaved” version in Scribus. This procedure will give you the latest automatically saved version of your Scribus document.

#### Emergency Backup Files

### Other Potential Sources for Errors

#### Missing Images

Images you have loaded into an image frame will not be stored in your Scribus file. Instead, Scribus will save the path to the image relative the Scribus file. When you open the Scribus file, Scribus will search for the image(s) used in the document in the paths stored in the file and the directory where the Scribus file itself is located. If you have moved either the Scribus file or the image(s) to another directory, Scribus probably won’t find the image(s) and display empty image frames. You can then use Extras > Manage Images to let scribus search for the new location of the image(s).

If you plan to exchange Scribus files with images between computers, you should always use File > Collect for Output to make sure all images are included.

Note that bitmap patterns will also have to be treated like regular images.

#### File Substitutions

Scribus not only saves the paths to images but also paths to other file types used in connection with your documents. These are fonts and color profiles. Upon opening a file, you will be asked to substitute both file types. See the font and color management chapters for more information. Note that substituting fonts and/or color profiles may have consequences for your layout or color correctness. To avoid potential errors, you are advised to export these resources with your Scribus document by using File > Collect for Output.

#### Render Frames

Since the content of Render Frames will be rendered anew each time you open a file, you have to make sure that third party applications used for rendering content are installed and configured correctly if you are exchanging files between computers and/or platforms. Otherwise, the frames will remain empty.

#### Settings/Preferences

If, for no obvious reasons, a Scribus installation that used to work without any issues suddenly starts to behave strangely or doesn’t work at all, the reason may be damaged Preferences files. In case you are encountering any strange behavior of Scribus you can try to rename the hidden `.scribus` directory that contains these files and start Scribus anew. The program will then create new configuration files from scratch. This may or may not solve the issue. If it doesn’t, the reason for your problem is probably unrelated to Scribus, e.g. a hardware issue or compatibility issues after an update of other components of your system, like a Windows update or a Qt4 update under Linux/UNIX. In such a case you can delete the newly created `./scribus` directory and restore the previously renamed folder. Of course this won’t solve your problem, but at least you don’t lose your previous default settings that way.