Skip to end of metadata
Go to start of metadata

There are a number of properties you can set for your Perspective projects within the Designer. For example, there are properties for setting security levels, configuring how the sessions receive updates, and more.

To access the Project properties, in the Designer, click on Project tab on the menu bar. Then select Project Properties.   


On this page ...

 Project properties span several functional areas each containing settings applicable to that area. Scroll down to the Perspective section.

Perspective General Properties

These general properties apply to the Perspective Sessions.

Enable Update NotificationEnables notifications for sessions when the project is changed. When notification is enabled, this is the message that will be displayed. The token {timeLeft} will be replaced with the seconds remaining until update. If false, update will be immediate.
Project LocaleSelect a project locale.
Include regional variationsEnables regional variations for the locale.

Hide from Launch Page and Native Apps

When selected, the project to be hidden from the Session Launcher and mobile app project listing.

Launch IconThe image specified here is used to represent the project on the launch page and desktop shortcut. This needs to be a path to an image that has been uploaded to the Gateway. Use the browse button to choose or upload a new image.
Project TimezoneTimezone for this project. Dropdown list includes the Gateway timezone, Session timezone, or specific timezones around the globe.
Identity Provider

Identity Provider (IdP) for this project. Dropdown list of available IdPs.

Note: The Identity Provider setting will only remain in this location if your Perspective Project already has an IdP set for it. If you change this property to none, it will no longer remain in this location. It moves to the Project Properties > Project General. 

For new installations, the Identity Provider property is now located in Project Properties > Project General. For more information, see Project Properties.

Session Timeout Desktop

The time, in seconds, for that the Gateway will wait for desktop devices to respond.

Session Timeout MobileThe time, in seconds, for that the Gateway will wait for mobile devices to respond.
Session Closed Message

Message to be displayed if system.perspective.closeSession is invoked.

Page Closed Message

Message to be displayed if system.perspective.closePage is invoked.

Perspective Permissions Properties

The Perspective Permissions properties restrict project access to specific security levels and security zones.

(Security Levels Tree)Interactive tree that shows the current authenticated roles and security zones.
(First radio button)If selected, then the security levels of the user must match all of the required security levels
(Second radio button)If selected, then at least one of the security levels of the user must match any of the required security levels.

In the following example, a user must have the Administrator security level and Ridgefield East security zone to be able to access this project.

Perspective Tag Drop Properties

Tag Drop properties provide a way to link certain data types of Tags to commonly used components when dragging-and-dropping a Tag onto a view. This is done in Project Properties under Tag Drop in three steps: select the data type, select the component to create, and select the bindings that are created on that component.

  • Data Type Configuration: This setting determines which components show up in the popup list when dragging a Tag into a view.
    You can switch between the different Tag data types to see what sorts of components are allowed to be dropped for each of those types. Add or remove new entries in the list using the Add  icon and Delete  icon. You can then double-click on the new blank cell and select a component from a dropdown.

  • Component Bindings Configuration: This setting determines which bindings are created when a component is dropped into a view.
    Select a component, then set up or modify the bindings for the selected component (which is typically just the Tag value bound to the value/text prop on a component). Add or remove new binding entries using the Add  icon and Delete  icon. Double-click the Tag Property and Prop Path cells to fill in properties. 

Note: The Component Binding Configuration table values are tied to the component currently selected in the Component Type dropdown, they are not related to what is selected in the Data Type Configuration table above.


Tag Drop

Dropping tags onto existing components can now create bindings on those components if the data type of the tag matches a Tag Drop configuration in the project. Tag Drop configuration is what determines if a binding is configured or not.

The Tag Drop interface enables the Bidirectional setting by default when adding Input Components.

Tag Drop



DataType Configuration

This section is to set up a list of components to show for each data type that can be dragged onto the view.

Data Types

Dropdown list of the available datatypes in Ignition. Choose a datatype to see a list of components associated with it.


List of components associated with selected data type.

Component Bindings Configuration

This section is to set up bindings when a Tag is dropped.

Component Type

Dropdown list of the available components in Perspective.

Tag Property

The name of a Tag's property to be used in a binding. "value" is most commonly used.

Prop Path

The property path on the component where the binding will be created. props.value or props.text are most commonly used.


Check box to indicate if the binding should be bidirectional.  The Bidirectional property is set by default when adding Input Components.

Perspective Inactivity Properties

Perspective has Inactivity Timeout settings in Project Properties. You can set an Inactivity timer that either closes the Perspective session or logs the user out if no activity is detected after a specified number of minutes. Activity is considered opening a new tab, clicking, typing. If Perspective is running on a mobile device, activity is considered a swipe or tap. The Gateway is the "time keeper" for inactivity timer.

This inactivity feature pertains to perspective sessions only. When the Inactive Session Action occurs (regardless of whether "Logout" or "Close Session" is selected), the user will still be logged into the Identity Provider.

Note: When enabling this inactivity feature, it is highly recommended that you also enable the "Always ask the IdP to re-authenticate users by default" setting under Project Properties, as this will require that any user attempting to log into a Perspective session will have to provide their credentials first. 

The following are the properties for the Inactivity Timeout:





Whether the automatic inactivity detection option is enabled.

Inactivity Timer

Time (in minutes) in which a session can be inactive before the user is logged out or the session is closed. The maximum value is 2,147,483,647. 

Grace Period

Grace period (in seconds) after the Inactivity Timer time has passed but before the user will be logged out or the session closed.

Grace Period Message

Message to be displayed before a session becomes inactive. Use the placeholder {seconds} to indicate remaining time. (Optional.)

Inactive Session Action

Action that occurs when the session becomes inactive. Options are: 

  • Logout - Log the user out of the session. Note that the user will still be logged in with the 
  • Close Session - Close the session.

  • No labels