---
title: How to convert old style Web.Instance.List to a V8 WebForm
slug: how-to-convert-old-style-webinstancelist-to-a-v8-webform
createdAt: 2025-06-11T20:26:20.403Z
---

There have been significant enhancements to the Browse Instances style pages in V8. Browse Instance now support complex searches and more complete filtering than before. V6 and below used an XML based format to configure these. A Web Form version of these was added in V7 and is now the only format supported.? 

This document explains how to convert from the old XML based format to the new Web Form version. 

1. Open the current Web.Instance.List XML parameter and take a note of the setup:

2. Rename the old parameter and create a new parameter called “Web.Instance.List"
3. Open the new WebForm and add the appropriate list control to the form e.g. for Jobs add the JobList, for ServiceInstances add the ServiceInstanceList, etc   
4. Select the new control and then set the following properties:
   1. SelectType = None 
   2. DefaultAction = Value set in original xml (e.g. approve) 
   3. DisplayFlags = Value set in original xml (e.g. ShowDate)
5. For each column in the “columns” section of the XML you will need to an ActivateGridColumn to the list control. Then set the following properties based on the values in the original xml: 
   1. Title 
   2. Width (if required) 
   3. BoundValue = You will need to add an “@” to the start of the expression. If there is a format expression remove it and set the format in Format property. 
   4. Format (if required) 

Your Web.Instance.List should look something like this:

If there are quick query buttons on the toolbar, these will need to be updated for V8.  

 

 

The following step explains what needs to be changed: 

1. Open the Web.Instance.Toolbar form 
2. On each Ribbon button update the following properties: 
   1. ImageUrl = search 
   2. OnClientClick = onQuery
3. Delete the deprecated “Click” property 

The Properties panel should now look something like this: