Knowledge Base

Using the Content Override Manager feature in Ion


Ion introduces a new feature called “Content Override” which allows IT pros to replace an entire page that would normally be loaded by a website with a new version of the page in the different location. Through this feature you can override, update or remove functionality of a website, all without making any changes on the website itself.


Feature specifics

Imagine this scenario: Your organization wants to replace the page ”targetpage.html” in with custom content. Due to license or access restrictions, you are not allowed to modify the content of the web server itself. Ion’s Content Override feature, you can achieve this goal: just configure the application’s Profile to replace the page with a different HTML file, or choose to block it altogether.


Before you begin

This article makes the assumption that you have…

  1. Installed the Ion Configuration Manager
  2. Installed the Browsium Client Package

If you have not completed these steps, please refer to the Ion Administration Guide that came with your Ion distribution package.



Follow these steps to configure this feature for your application & Ion profile

1. Open the Browsium Ion Configuration Manager. Load your Project from a file by clicking the “Open Project” option from the “File” menu. Alternatively, you can load the currently running settings for Ion into memory via the “Load Local Settings” option from the “File” menu

2. Locate the “Objects” pane on the left. Click on the ‘+’ to the Project’s left. Do the same for “Profiles” and your working Profile. Now select the “Content Override Manager” node under your profile

3. Click “Add Content Override…” in the Actions pane on the right and you will see the following screen:

4. Type the full URI, including the protocol identifier, in the Target URI field. This is the page you want to override. E.g., enter “” (without quotation marks)

5. Change the ‘Action’ field based on the following table:

‘Action’ optionUsage: Use this option if…
URL (default)… the page you are replacing the original content with lives at a URL on a webserver (http://foo)
Local… the page you are replacing the original content with lives on the local filesystem (“c:\temp\test.htm” or \\server\share\test.html
Content… you are going to type in the full HTML of the page in the Configuration Window. In this manner you can write HTML directly into the Configuration Manager. Note you must enter valid HTML, including all appropriate headers, etc. (HEAD, BODY, etc.)
Block… you wish to simply block the resource from being loaded at all


6. In the ‘Data’ field, enter the path to content. Be sure to include the fully qualified path to the resource (examples are shown in the table above). Be sure the location of the file matches the Action type you’ve selected (don’t provide the path to a local file if you’ve selected the URL action). For URIs where your ‘Action’ is ‘Block,’ leave the ‘Data’ field blank

7. Click “OK” to save your changes

8. Save your Project if required (via the “File” menu)

9. Test your change. Choose “Save local settings” from the “File” menu. The Ion processes will restart. After the green Ion splash screen appears and disappears, open your browser and visit the web application. “” should now show your new content (or be blocked if you chose the ‘Block’ action

Versions Affected:
Ion 2
Ion 3

Posted in: Ion Knowledge Base,

  • Share:  

Request Demo

Internet Explorer End of Life problems?Learn More