Item Selector

The Item Selector is the information that gets saved when you perform an action (e.g. extract, click) on an element in a web page. It helps WebGet find this element each time the task is run. This information is hidden from the user unless the Show Advanced Settings (Accounts menu) is ticked or the user clicks the "show details" link.

The Item Selector is made up of the items below. It must contain either a Dom Path, a Class Path or an Advanced Selector. If an Advanced Selector is specified all other items will be ignored. If both a Dom Path and Class Path are specified, WebGet will attempt to find the item using the Dom Path first followed by Class Path.
  • Dom Path: The location of the element in the Html Document Object Model (DOM). This is similar to the path to a file in a file system. You should only modify this value if you understand the Html document structure.
  • Dom Path Class Check: An optional check to make sure the element found (using the Dom Path) is correct. If specified, the element must contain the Css (Cascading Style Sheet) class specified. This helps to ensure that the correct element is found each time the task is run.
  • Class Path: The path to the item using a Css Selector. More information on Css Selectors can be found in this reference guide. The expression must produce exactly one match. If no matches are found, WebGet will repeat the search after removing the topmost class (e.g. if ".btn .btn-default" is not found WebGet will then search for only ".btn-default").
  • Text Check: An optional check to make sure the element found is correct. If specified, the element must contain the text specified. The text must be an exact match but is not case sensitive. For example, if you are looking for a button called "Submit Form", a Text Check of "Submit" will fail but "submit form" will be successful.
  • Advanced Selector: An advanced method for selecting the element which can handle multiple Dom Path's. For more information see the Advanced Selector page.
If you change any of the values in the Item Selector, WebGet will attempt to find the element in your target page by highlighting it in orange. If the element isn't found this is a warning that your task will not run correctly.