User Guide (Version 1.21)


This feature is in preview release and is subject to change.

Use the Portal component to create efficient indoor areas with the VisArea component. You can use portals to specify areas where you can look out of a visible area and see beyond it, such as windows or doors between visible areas.

To use the Portal component, its volume must overlap at least two or more visible areas.


You can't modify the OccluderArea, Portal, and VisArea components at runtime.

Portal Component Properties

                The Portal component properties in
                    Lumberyard Editor.

The Portal component has the following properties.

Name Description


The height of the portal.


Displays the portal as a filled volume in the Lumberyard Editor viewport.


Specifies whether the sun affects objects in the portal.


A multiplier on how far the portal is rendered.


Renders only the skybox outside the portal.


Renders the ocean outside the portal.


The portal is treated as an object with a volume instead of a plane.

If false, the portal acts as if it does not have a volume and is treated like a plane between the four floor points.


Cameras can look through the portal from both sides. If false, the portal only works from one side.


Specify whether to blend light between connected visible areas.


The amount of light to blend between connected visible areas.


The vertices that define the floor of the portal.


Choose Edit, and the component is locked for editing. For more information, see Editing Components in the Viewport.

Portal Component Examples

Example 1

In the following examples, two boxes are inside several visible areas. The visible areas are connected by the portals, which are green. The portal lets you see between the visible areas. The shadows of the boxes inside the visible areas appear because the AffectedBySun option is enabled.

                    Two Portal components connecting multiple
                            VisArea components.

Example 2

The following example shows how the portal lets you see between two visible areas. Although the boxes are in separate visible areas, the portal creates a window between them so that you can see both boxes.

                    Portal component creates a window between two
                        visible areas.

Example 3

In the following example, you see the portal at an angle. You can't see the box in the other visible area because there is no portal in that line of sight.

                    Portal doesn't render objects that aren't in the line of sight.

Example 4

In the following example, you can see a box through a different portal, but because the DoubleSide option is disabled, the portal is one-sided.

                    Portal component with
                            DoubleSide option disabled.

Example 5

In the following example, if you go through the portal and look back, you can see the other visible areas, but you can't see the boxes in those areas. You can't see through portals that aren't connected to the visible area that you're in.

                    Visible areas must be connected with a Portal
                        component to view between them.