<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/PortalComponent/init(target:plane:options:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15PortalComponentV6target5plane7optionsAcA6EntityC_AC5PlaneVAC7OptionsVtcfc"
  },
  "title" : "init(target:plane:options:)"
}
-->

# init(target:plane:options:)

Creates a portal component with a target entity, a single planar definition, and portal options.

```
init(target: Entity, plane: PortalComponent.Plane, options: PortalComponent.Options)
```

## Parameters

`target`

A target world entity the portal is looking into.

`plane`

A plane for configuring clipping and crossing features.

`options`

An option set that determines which clipping and crossing features to enable.

## Discussion

Use this initializer to toggle [`clippingMode`](/documentation/RealityKit/PortalComponent/clippingMode-swift.property) and
[`crossingMode`](/documentation/RealityKit/PortalComponent/crossingMode-swift.property)
with the same [`PortalComponent.Plane`](/documentation/RealityKit/PortalComponent/Plane).

For new code, prefer [`init(target:clippingMode:crossingMode:)`](/documentation/RealityKit/PortalComponent/init(target:clippingMode:crossingMode:)), which lets you configure
clipping and crossing independently and supports [`PortalComponent.ClippingMode.volume(_:)`](/documentation/RealityKit/PortalComponent/ClippingMode-swift.enum/volume(_:))
and [`PortalComponent.CrossingMode.volume(_:)`](/documentation/RealityKit/PortalComponent/CrossingMode-swift.enum/volume(_:)) for box-shaped boundaries.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)