Downgrade a RoboHelp Project
Contents
A recurring forum question is whether you can downgrade a RoboHelp project. You may need to do this when you accidentally upgraded a project when trying out a new version of RoboHelp. Or you may need to do this when you receive a project from another author or another company.
Fortunately, it’s rather simple to downgrade a project to RoboHelp 8 (or a higher version). There is a but: if the project use features that are not available in the lower version of RoboHelp, these features will not work. RoboHelp may even become unstable and crash the project. But as long as you have simple topics, you should be fine. Check Peter Grainge’s RoboHelp Guide for an overview over all new and improved features of the different RoboHelp versions.
The first thing you need to do before downgrading, is to create a backup of your current project. You need to make changes to the RoboHelp project files and you can corrupt your project. So make a backup first!
This page was last updated on: 31-07-2017
![]() |
Need help recovering or downgrading your project? Contact us to find out how we can help. If you are recovering a project, you may also be interested in our recovery scripts package. |
Issues You May Encounter on Downgrading
Here is a short list of issues I know you may encounter on downgrading. This list is not exhaustive, but only a list of issues I am aware of.
To Version | Severity | Changes that may impact your project |
---|---|---|
2015 patch | Low |
|
11 or lower | Low |
|
10 or lower | Blocking | RoboHelp 11 changed the way drop-down hotspots changed. If you use drop-down hotspots, downgrading your project may break existing drop-downs. |
10 or lower | Low | RoboHelp 11 introduces Responsive HTML5. These Single Source Layouts and Screen Layout will not work in RoboHelp 10. Remove them before downgrading. |
9 or lower | High | RoboHelp 10 introduced variables in topic titles. Downgrading a project with variables in topic titles may have unpredictable results. |
8 | Medium | Tracked changes were introduced in RoboHelp 9. Downgrading a project with tracked changes may have unpredictable results. |
8 | Very Low | The location of the project’s language file changed. On downgrading, paste the language files form the folder /!language!/<your language>/ to the root of the project. |
7 or lower | – | Since the entire structure of RoboHelp changed, you can’t just downgrade. See Downgrading to other versions |
All these issues can be resolved through scripting and find/replace operations.
Downgrading with Source Control
When you use source control, I recommend that you add the downgraded project as a new project to source control. This will make the downgrade process easier. If you do not want to add the downgraded project as a new project, be sure to check out your project before trying to downgrade.
When you want to add the project as a new project to source control, you must remove the source control link from the project. See Rick Stone’s article Banishing the sorcery for detailed instructions.
Downgrading Minor Versions (Patches)
Patches may include new functionality or features. Whenever a new feature is introduced in a patch, patch versions may no longer be backwards compatible. To downgrade to a previous patch level, follow these steps:
- Make a backup of the current project. Do not proceed unless you have a working backup.
- Find the .CPD file in the project directory and delete it.
- Open the .XPJ file with notepad or another text editor.
- On line 2, change the value of minorversion to 1.
- Save your .XPJ file.
- Open your RoboHelp project.
If RoboHelp asks to update the project, allow RoboHelp to update. This is regular behaviour to get the project version to the correct patch level.
Downgrading to RoboHelp 2015, 11, 10 or 9
Follow these steps to downgrade your project from RoboHelp 2017/2015/11/10 to RoboHelp 2015, 11, 10 or 9:
- Make a backup of the current project. Do not proceed unless you have a working backup.
- Find the .CPD file in the project directory and delete it.
- Open the .XPJ file with notepad or another text editor.
- On line 2, change the value of majorversion to the correct version:
- For RoboHelp 2015, change the majorversion to 7 and the minorversion to 12.
- For RoboHelp 11, change the majorversion to 6.
- For RoboHelp 10, change the majorversion to 5.
- For RoboHelp 9, change the majorversion to 4.
<rhpml majorversion=”4″ minorversion=”0″>
- Save your .XPJ file.
- Open your RoboHelp project.
Downgrading to RoboHelp 8
Follow these steps to downgrade your project from RoboHelp 11/10/9 to RoboHelp 8:
- Make a backup of the current project. Do not proceed unless you have a working backup.
- Find the .CPD file in the project directory and delete it.
- Open the .XPJ file with notepad or another text editor.
- On line 2, change the value of majorversion to 3.
<rhpml majorversion=”3″ minorversion=”0″>
- Save your .XPJ file.
- In the project directory, go to the folder !Language!.
- Open the folder named with the language code of your project. For example, if your project is in US English, open the folder en_US.
- Select the following files:
- RoboHHRE.lng
- File with the extension .IGN
- File with the extension .PHR
- File with the extension .STP
- File with the extension .SYN
- Copy the selected files and paste them in the root of the project.
- Open your RoboHelp project.
Downgrading to other versions
Downgrading to versions older than RoboHelp 8 is not easy. With RoboHelp 8, Adobe changed the internal structure of projects, so you can’t simply trick RoboHelp as you can for RoboHelp 8 or later.
If you do need to downgrade to earlier versions of RoboHelp, start with Peter Grainge’s topic on opening projects. If you would like professional help, don’t hesitate to contact us.