Automatic document conversion to fixed size - DocumentUpgrade.xml

To ensure a consistent automatic conversion of 2018 and older documents to the new layout system introduced in TARGIT 2019 please follow these steps:

  1. Create a file named “DocumentUpgrade.xml” in the default Settings folder of the TARGIT Server:
  2. Copy and paste the following into the file using a text editor like Notepad:
<?xml version="1.0" encoding="utf-8"?>
<Setting name="ConvertHeight" value="PUT INTEGER VALUE HERE (PIXELS)" />
<Setting name="ConvertWidth" value="PUT INTEGER VALUE HERE (PIXELS)" />

The integer values (pixels) inserted into the file should be as close to the size of a “good looking” document as possible, that is, a document where objects are displayed as you like and without unintended scrollbars, enlarged texts, etc.

The best way to find this is to open 2-3 documents in the 2019 version and set a custom size in the Page
Settings dialog and check ‘Resize objects to fit page’ before clicking OK.



We recommend the 1600 x 900 pixels option, as this is the default setting for any new dashboards in TARGIT 2019 and later versions.

When you have found a height and width that appears to be a good indicator for conversion values place them in the xml file. Whenever you open a document that was last saved in versions older than the 2019 version, they will be converted to this specific size.

Was this article helpful?
1 out of 1 found this helpful


  • Hi Ole,

    Quote: "We recommend the 1600 x 900 pixels option, as this is the default setting for any new dashboards in TARGIT 2019 and later versions.".

    Was wondering why you recommend 1600 x 900.

    Most screens are much wider, leaving quite a lot of empty space on both sides of the screen, which can be used for a dashboard or which increases the font size.
    I'm asking this because I'm transferring dashboards from 2017 to 2021 and they are all different sizes (e.g. 1527x650 or 1927x852). Those dashboards look good, but consistency is also nice.
    I have a large screen myself, but I also have to take into account smaller laptop screens (15 inches or perhaps 13 inches). I see that the font size does get very small at 1600x900 and a smaller screen size.

    Can you advise? Maybe a size that uses more the width of the screen.


  • Consistency will make life easier for you going forward.

    The ideal size will always be a compromise. E.g. if you are working on a 1920 x 1080 screen (which is a 16:9 format), you might argue that the best resolution for your dashboards might be 1600 x 900.

    However, you will never be able to exploit the full screen size when opening a TARGIT analysis. In the Windows client you may or may not have the ribbon or a criteria bar taking up a bit of the space plus the other parts of the Frame" of the client. In the Windows client I found that the best "effective" ratio is closer to 19:9 (with hidden Ribbon and hidden Smartpad). This will leave less space at the left adn right edges. Whether this is true in the Anywhere client, depends on the browser, on the user's preferences with regard to bookmark bars etc.

    If you go for the 1900 x 900 pixels you might experience that things may look tiny on smaller screens. So you may consider another 19:9 format, e.g. 1425 x 675 (1900 x 900 scaled to 75%). This will make things appear bigger, but also reduce the amount of objects/data that you can fit into a single dashboard.

    BR / Ole

  • Thanks Ole for your thoughts!

    We are using a navigation bar and a menu in the anywhere client, so I think I have to calculate a format myself. The most important thing is the layout of the anywhere client, because all colleagues use it. 1425x675 is a little bit too big (not all the data is visible in the crosstab). 

    I will indeed weigh up the pros and cons of a 1600x900 resolution or a custom size.

    It is not possible to create separate layouts per screen size (13 inch, 15 inch, 17 inch etc). Targit only recognizes Desktop, Mobile or Tablet?


  • Correct. We do recognize the device type (PC, Tablet, Smartphone), but we cannot recognize a specific screen size.

    You can still create multiple layouts for different screen sizes, and end-users will be able to select these manually - but not in an automatic way.

  • Thanks Ole. How can a end-user select a different lay out? 

  • Hi Frank,

    From the Windows application, the Consumer user can choose between layouts from the Layouts Smartpad.

    In the Anywhere client, the Consumer User has a Layouts button in upper right corner:

    From the Mobile client, the user can swipe from one layout to another.

  • Hi Ole, 

    Is this still supported? I upgraded a client from 2018 to 2021 and I can't seem to get this to work. I've tried restarting the TARGIT server, but I am still seeing every dashboard loading in seemingly random resolutions. Thanks in advance for any advice!

  • Hi Tricia,

    Yes. It should still work.

    You should be careful about exact naming and placement of the xml file - as well of correct syntax of the script itself.

    BR / Ole


Please sign in to leave a comment.