> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/hypersim/model-and-simulation/edit-a-model-schematic/create-and-manage-designs/manage-attributes/property-browser.md).

# Property Browser

## Overview

The **Property Browser** (also referred to simply as the **Browser**) provides a spreadsheet-style view of schematic data, making it easy to view, edit, and navigate design information.

Each row in the Browser represents a schematic object, such as a **device**, **signal**, **pin**, or **net**. Each column corresponds to an attribute field, and each cell displays the value of that attribute for the object in the selected row.

For **nets**, the Browser displays the associated signal and all connected pins, providing a convenient way to review and manage connectivity within the design.

By presenting schematic data in a tabular format, the Property Browser enables efficient inspection and editing of large amounts of design information.

## Property Browser window

To open the **Browser**, go to the **Home** ribbon and click **Property Browser**. By default, the **Property Browser** displays all devices in the current schematic.

If one or more objects are selected in the schematic when the Browser is opened, only the selected objects are displayed. When both devices and signals are selected, **devices take precedence**, and only the selected devices are shown.

<table><thead><tr><th width="200" valign="top">Command</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Close Box</strong></td><td>Click this control (x) to close the Browser window. Another method of closing is to select the Browser item in the View menu.</td></tr><tr><td valign="top"><strong>File Menu</strong></td><td>This menu contains the <strong>Save As</strong> command, which allows you to save the contents of the spreadsheet as a text file.<br>The Browser exports data in a tab-delimited text format commonly used by spreadsheet and database programs.</td></tr><tr><td valign="top"><strong>Edit Menu</strong></td><td>This menu contains the standard clipboard editing commands which allow you to operate on selected cells in the spreadsheet.</td></tr><tr><td valign="top"><strong>Select Menu</strong></td><td>This menu contains options to control the type of objects displayed and how they are selected.</td></tr><tr><td valign="top"><strong>Attribute Type Selector</strong></td><td>This list allows you to select what type of fields are shown in the Attribute List. By default, only Primary fields are shown, i.e. attribute fields marked as Primary in the Defining Attribute Fields command. You can also select to show:<br><strong>Secondary fields</strong>: fields not marked as Primary<br><strong>Pseudo attributes</strong>: Text values that are associated with an item by the system, but are not normal attribute fields, including the internal part name and graphical information.<br><strong>Definition fields:</strong> All attribute fields not marked Keep with Instance in the Define Attribute Fields table.<br><strong>Instance fields:</strong> All attribute fields marked Keep with Instance in the Define Attribute Fields table.</td></tr></tbody></table>

{% hint style="info" %}
Commands in the main application menu bar do not affect the Property Browser. For example, the **Cut**, **Copy**, and **Paste** commands in the main application continue to operate on the selected schematic objects, not on the data displayed in the Browser.
{% endhint %}

### Select **the object to display**

The **Property Browser** is controlled by its own **File**, **Edit**, and **Select** menus located within the Browser window. These menus operate independently of the main application menus.

When a **Selected object type** is chosen, only objects currently selected in the schematic are displayed. For example:

* **Selected Devices** displays only the devices selected on the schematic.
* **Selected Signals** displays only the selected signals.
* **Selected Pins** displays only the selected pins.
* **Selected Nets** displays only the selected nets.

This filtering capability allows you to focus on specific portions of the design and work efficiently with the objects that are of current interest.

When searching for objects, the **Property Browser** limits the search to the scope selected in the **Scope** drop-down menu. This allows you to focus searches on a specific area of the design and avoid unrelated results.

Four search scopes are available:

<table><thead><tr><th width="200.0001220703125" valign="top">Command</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Design</strong></td><td>In this scope the entire design hierarchy is searched for objects of the correct type.<br>This scope has a side-effect. Some of the objects attribute values displayed may not be editable because of definition/instance conflict resolution. The uneditable objects and/or fields will be displayed with a gray background.</td></tr><tr><td valign="top"><strong>Circuit</strong></td><td>In this scope the search is limited to the pages of the circuit with the most active window.</td></tr><tr><td valign="top"><strong>Here Down</strong></td><td>In this scope the search for objects is in the circuit with the active most window and in all circuits below it in the hierarchy. Some of the objects and/or fields may not be editable for the same reasons as explained in Design scope.</td></tr><tr><td valign="top"><strong>Page</strong></td><td>This scope only looks for objects in the circuit with the most active window and in addition only looks at the page associated with that window.</td></tr></tbody></table>

Choosing the appropriate scope can significantly improve search efficiency, especially when working with large hierarchical designs.

### Select the attribute to display

To add an attribute field to the spreadsheet, double-click its name in the **Attribute List** and it is added as a new column at the end of the spreadsheet. Selected attributes are indicated by a check mark next to their names. To remove an attribute column from the spreadsheet, double-click the checked attribute name.

The contents of the **Attribute List** change according to the currently selected object type. Only attributes that are applicable to that object type are displayed.

By default, rows are sorted based on the first column in the spreadsheet. You can change the column order by dragging columns to new positions, allowing you to customize the layout and control the sort key.

### Edit value in the spreadsheet

To edit a value, click the desired cell and begin typing. Changes are applied directly to the corresponding attribute of the associated schematic object.

Cells displayed with a **gray background** are read-only and cannot be edited from the Property Browser. This may occur when the attribute itself is not editable or when the circuit or subcircuit containing the object is locked.

{% hint style="danger" %}
Modifying a cell immediately updates the corresponding attribute value in the schematic. Changes take effect as soon as they are entered, and no undo operation is available. Exercise caution when editing data in the Property Browser, especially when working with multiple objects or critical design attributes.
{% endhint %}

<table><thead><tr><th width="200.00006103515625" valign="top">Command</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Using the Edit Menu Commands</strong></td><td>The Edit menu in the Browser panel contains the standard clipboard editing commands Cut, Copy, Paste, and Clear, <strong>plus four additional menu items:</strong></td></tr><tr><td valign="top"><strong>Fill Down</strong></td><td>The Fill Down command takes the selection rectangle and copies the values in the cells at the top of the selection to all the selected cells below them.</td></tr><tr><td valign="top"><strong>Fill Right</strong></td><td>The Fill Right command takes the selection rectangle and copies the values in the cells at the left of the selection to all the selected cells to the right of them.</td></tr><tr><td valign="top"><strong>Make Visible</strong></td><td>The Make Visible command takes the object attributes affected by the selection rectangle and makes them visible in the schematic. This command applies only to attribute values (not pseudo-attributes like the part name) and only to visible objects. For example, it is not possible to display attributes associated with bundle internal signals.</td></tr><tr><td valign="top"><strong>Make Invisible</strong></td><td>The Make Invisible command takes the object attributes affected by the selection rectangle and makes them invisible in the schematic.</td></tr></tbody></table>

You can rearrange columns by dragging them to a new position within the spreadsheet. This can be useful when organizing data or bringing frequently used attributes closer together.

<table data-header-hidden><thead><tr><th width="200.00006103515625"></th><th></th></tr></thead><tbody><tr><td><strong>Resizing Columns</strong></td><td>Columns may be resized by moving the cursor into the column heading area and positioning it over the vertical dividing line. The cursor when correctly positioned it will change shape. Press the mouse button and drag the line to size the column to its desired size. Rows cannot be resized.</td></tr><tr><td><strong>Moving Columns</strong></td><td>Columns are reordered by moving the cursor into the column heading area and positioning it over the column heading to move. Click once on the column label to make the column become selected, then hold and drag the label to its new position.</td></tr></tbody></table>

#### Disallowed Editing Changes

The Property Browser prevents any edit that would result in a structural change to the schematic's connectivity. Although some of these changes may be valid when performed through other schematic editing operations, they are not permitted within the Browser and will be rejected.

Such cases are uncommon, but they typically involve changes that would alter how signals are connected. Examples include:

* **Renaming a visible signal** to the name of another visible signal on the same schematic page. Doing so would merge the two signals into a single net, changing the design connectivity.
* **Making a signal visible** when another visible signal with the same name already exists on the same page. This would also cause the signals to merge into a single net.

To preserve design integrity, the Browser blocks these operations and leaves the existing schematic connectivity unchanged.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/hypersim/model-and-simulation/edit-a-model-schematic/create-and-manage-designs/manage-attributes/property-browser.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
