Official Content

Warning: Since GeneXus 16, it is strongly recommended to create a User Control object instead of creating a Web User Control.

This article describes the steps to install User Controls. 

Automatic Installation

1. Run GeneXus and find the user control you want in the Start Page
(In the Start Page, go to the Marketplace tab and use the search bar to look for the control).

2. Click install

3. GeneXus will ask you whether you want to install the control, click YES

4. GeneXus will ask you whether it can restart, click YES

5. Check that the toolbox has added the new option under the User Controls section.

6. Enjoy!

Manual installation

1. Download the control from GeneXus Marketplace.

2. Unzip files

3. Copy the directory under the UserControls directory in the GeneXus installation.

4. Execute GeneXus with the /install parameter. For example: <GX_Installation_Path>\GeneXus /install

5. Check that the toolbox has added the new option under the User Controls section.

6. Enjoy!

How are the UCs copied to the application directory?

UCs are installed in the GX installation directory (i.e. UserControls\UserControlName) and all the UCs being used by an application are automatically copied from the GeneXus Installation directory to the application directory (e.g. CSharpModel\Web\UserControlName). 

Note: This copy is done during the build process. Once each User Control being used is copied, a file named “UserControlName.versionId.ver” is created in the application directory (e.g.  CSharpModel\Web) in order to avoid copying the UCs again.

When providing UCs, it is advisable to include the tag “<Version>Number</Version>” in the UserControlName.control file. If this recommendation is followed, the newer version of the user control is copied to the application directory once the UC installation process is complete (i.e. “genexus /install” execution) and building the application.

How to update a User Control

What happens when you download or receive a new version of a User Control?
Follow the steps below :

1. Close GeneXus if it is open.

2. Replace the files of the User Control which have been updated in the User Control folder under GeneXus installation path.

3. Execute GeneXus with the /install parameter. For example: <GX_Installation_Path>\GeneXus /install

4. Check that the toolbox has added the new option under the User Controls section.

5. Enjoy!

How to delete a User Control

Similar steps need to be followed to delete a User Control from your GeneXus installation.

1. Close GeneXus if it is open.

2. Delete (or move) the User Control folder under GeneXus installation path.

3. Execute GeneXus with the /install parameter. For example: <GX_Installation_Path>\GeneXus /install

4. Check that the User Controls is not present in the toolbox.

Note: Since GeneXus 15 Upgrade 2 if you run genexus /install (instead of genexus.exe /install) as an administrator, the result of the installation process is shown in the output.


Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant