We need you!


The IzPack documentation needs work, and you are invited to edit it!

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: fixed some typos taget->target


Code Block
titleExample definition
<panel classname="TargetPanel">
   <validator classname="com.izforge.izpack.installer.validator.ConditionValidator"/>


Once chosen, the IzPack variable INSTALL_PATH is set to the user's choice.


IzPack offers the possibility to set a list of default installation directories depending on the target installation platform. When  When the compiled installer is executed, IzPack chooses the one matching the assigned platform. This  This can be achieved by explicitly setting variables with the prefix: TargetPanel.dirIzPack recognizes this as a built-in variable which can be user-modified.

 For a more detailed description see Setting Default Installation Directories.

Built-in VariableDescriptionDefault Value


(see Setting Default Installation Directories)

The platform-specific default installation path, which can be overridden by the user in TargetPanel.

(gathered automatically according to the OS and platform)

ShowCreateDirectoryMessageWhether to show the "Target directory will be created" dialog if a directory does not exist.true


The text for these keys is specified in language resource files as described in the section on Internationalizing resources.

KeyDefault (English)Description
TargetPanel.headlineTarget Path

The headline of the panel (the one with the white background).

GUI only: This is a standard translation for all type of graphical panels, if the <guiprefs> modifier useHeadingForSummary is set "yes".This has no effect on console installations.

TargetPanel.summaryCaptionInstallation Path

The summary caption text of the panel.

GUI only: This is a standard translation for all type of graphical panels, if the <guiprefs> modifier useHeadingForSummary is not set or different to "yes". This has no effect on console installations.

TargetPanel.infoSelect the installation path: The label text above the target directory edit field.
TargetPanel.browseBrowse...The label text of the directory chooser button.
TargetPanel.warnThe directory already exists! Are you sure you want to install here and possibly overwrite existing files? Warning message if the directory specified already exists.
TargetPanel.open  ??????????????
TargetPanel.incompatibleInstallationIncompatible installation detected. Uninstall it first, or choose another directory to install to. Warning message if the specified location is not suitable for a new installation.
TargetPanel.empty_targetYou have not specified a target location! Is this correct? Warning message given when the user has not selected a target but has pressed OK.
TargetPanel.notwritableThis directory can not be written! Please choose another directory! Warning that IzPack can not create files in the selected location.
TargetPanel.createdirThe target directory will be created: 
TargetPanel.nodirThis file is not a directory! Please choose a directory! 
PathInputPanel.intro Intro text with an explanation, rarely used, is empty by default.
PathInputPanel.extendedIntro Mult-line intro text with an explanation, rarely used, not set by default.
PathInputPanel.requiredThe chosen directory should exist. 
PathInputPanel.required.forModificationInstallationThe chosen directory should exist.The alternative for PathInputPanel.required, if the IzPack variable modify.izpack.install is set "true" and an .installationinformation file exists in the target folder.
See the  InstallationTypePanel for more installation how the modify.izpack.install variable is automatically set.
PathInputPanel.notValidThe chosen directory does not contain the required product. 

To change the text "Select the installation path:  " to "Select the folder where My Application 2.1 should be installed: ",  TargetPanel.info should be specified in a language resource file for each language supported.


Code Block
    <res id="TargetPanelText.xml" src="TargetPanelText.xml"/>
    <res id="TargetPanelText.xml_fra" src="TargetPanelText.xml_fra"/>

The TargetPanelText.xml file which is the default language resource, should look something like this:

Code Block
	<str id="TargetPanel.info" txt="Select the folder where $APP_NAME $APP_VER should be installed."/>

A similar TargetPanelText.xml.fra file needs to be created to specify the French translation.