Skip to main content
Version: 7.9


This function is used in Python Scripting.


Returns an array of tags from a specific folder. The function supports filtering and recursion. Leave filters blank to return all tags.

If called in the gateway scope, a Tag Provider must be specified.


This function cannot browse Client tags.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.


system.tag.browseTags(parentPath, tagPath, tagType, dataType, udtParentType, recursive, sort)


StringparentPathThe parent folder path. Leave blank for the root folder.
Note: You can specify the tag provider name in square brackets at the beginning of the parentPath string. For example, [myTagProvider]MyTagsFolder. If the tag provider name is left off then the project default provider will be used.
StringtagPathFilters on a tag path. Use * as a wildcard for any number of characters and a ? for a single character.
StringtagTypeFilters on a tag type. Possible values are OPC, MEMORY, DB, QUERY, Folder, DERIVED and UDT_INST.
StringdataTypeThe data type of the tag. Not used for UDT instances or folders. Possible values are Int1, Int2, Int4, Int8, Float4, Float8, Boolean, String, and DateTime.
StringudtParentTypeThe name of the parent UDT.
booleanrecursiveRecursively search for tags inside of folders. Default is False. See the panel below for more details.
StringsortSets the sort order, possible values are ASC and DESC. Sorting is done on the full path of the tag.


BrowseTag[] - An array of BrowseTag. BrowseTag has the following variables: name, path, fullPath, type, dataType, and the following functions: isFolder(), isUDT(), isOPC(), isMemory(), isExpression(), isQuery().



The Recursive Parameter

The recursive argument will allow the function to recursively search for tags inside of folders. In larger Tag Providers, recursively calling this function will take some time to complete, and take a fair amount of system resources to complete. In these scenarios, it's not uncommon for a timeout to occur if the request originated from a client.

It is highly recommended that the native recursive behavior on this function is disabled. Instead, manual recursion may be utilized by making multiple function calls in your code. This allows the browse to occur in a timely manner, and in smaller segments of work. See the examples below for more details.

Code Examples

Example #1
# Example 1: Browse all tags in a specific folder

tags = system.tag.browseTags(parentPath="")
for tag in tags:
print, tag.path, tag.fullPath, tag.isFolder(), tag.isUDT(),
print tag.isOPC(), tag.isMemory(), tag.isExpression(), tag.isQuery(),
print tag.isDB(), tag.type, tag.dataType
Example #2
# Example 2: Recursively browse tags
# Note, it is highly recommended to set recursive to false, and manually iterate through the node with multiple function calls. See the Manual Recursion example for details.

tags = system.tag.browseTags(parentPath="", recursive=True)
Example #3 - Gateway Scoped Recursion
# Example 3: Manual Recursive Browse.
# Iterates through several browseTags() calls in a single script. This helps prevent server timeouts by browsing individual folders at a time, spreading the workload over multiple calls.

# This function was designed to run from a Gateway Scoped call. Client based calls (such as those triggered by a button press) should search in an asynchronous thread.

# Define the search as a function. This makes recursion easier.
def manualSearch(initPath):

# If troubleshooting, you could print out the initPath here

# Create a result set of just tags. This call could be modified to look for a specific sub of tags,
# such as just UDT instances
tagSet = system.tag.browseTags(parentPath = initPath, tagPath = '*',

# Create a result set of just folders. We'll iterate over this set and call browseTags() again for the results.
folderSet = system.tag.browseTags(parentPath = initPath, tagPath = '*',
tagType = 'Folder',

# Iterate through our folders...
for folder in folderSet:

# If troubleshooting, you also could print out folder.path here.

# ...And start the process over again until we run out of folders.

# Return the list of tags.
return tagSet

# Call this on the manual tag provider. Change the intialPath here if searching through a specific Tag Provider.
myTags = manualSearch("[MyProvider]/folder")
Example #4
# Example 4: Browse tags of a the same UDT parent type

tags = system.tag.browseTags(parentPath="", udtParentType="Motor")
Example #5
# Example 5: Browse tags of a the same type

tags = system.tag.browseTags(parentPath="", tagType="OPC")
Example #6
# Example 6: Browse tags using a tag path filter

tags = system.tag.browseTags(parentPath="", tagPath="*Folder1")