---
title: "system.gui.getSibling"
description: "Given a component event object, looks up a sibling component."
---

# system.gui.getSibling

> Given a component event object, looks up a sibling component.

This function is used in **Python Scripting**.

## Description
Given a component event object, looks up a sibling component. Shortcut for `event.source.parent.getComponent("siblingName")`. If no such sibling is found, the special value None is returned.

## Client Permission Restrictions
This scripting function has no Client Permission restrictions.

## Syntax
`system.gui.getSibling(event, name)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
EventObject| `event` | A component event object.
String| `name` | The name of the sibling component.

### Returns
**VisionComponent** - Returns reference to the sibling component. See [VisionComponent](https://files.inductiveautomation.com/sdk/javadoc/ignition81/8.1.0/com/inductiveautomation/vision/api/client/components/model/VisionComponent.html).

### Scope
Vision Client

## Code Examples
```python title="Example #1"
# This example gets its sibling Text Field's text, and uses it.
  
textField = system.gui.getSibling(event, 'TextField (1)')
if textField is None:
   system.gui.errorBox("There is no text field!")
else:
   system.gui.messageBox("You typed: %s" % textField.text)
```