---
title: "Holdouts in Katana"
canonical: "https://rmanwiki-25.pixar.com/space/RFK25/18481388/Holdouts%20in%20Katana"
format: markdown
---
[Holdouts](https://renderman.atlassian.net/wiki/pages/createpage.action?spaceKey=RFK24&title=Holdouts) can be created with the PrmanHoldoutCreate macro.

![image](media://0dbc471e-0d69-48cb-b1c9-77ae85580b46)

 The PrmanHoldoutCreate macro has several parameters to control the behavior of the render:

**holdoutGeo**: Add all the geometry that you want to act as a holdout here.

**Mode**:

- Off: Turn off holdout workflow. Ignore this macro.
- Composite: Composite the holdout image over the background image specified in the imagePlaneSettings.
- No Composite: Create the holdout image without compositing the background image.

**outputAOVs**: Write the shadow and occluded AOVs to the renderLocation. The image names will be holdout_shadowAOV.exr and holdout_occludedAOV.exr.

**renderLocation**: Render directory for the shadow and occluded AOVs. The renderLocation is set to $KATANA_TMPDIR unless otherwise specified. This parameter is available when outputAOVs is checked.

**imagePlaneSettings**: The Filename parameter is where you will specify the background image.  All the settings in this group are the same parameters on the [PxrImageDisplayFilter](https://renderman.atlassian.net/wiki/pages/createpage.action?spaceKey=RFK24&title=PxrImageDisplayFilter). The macro uses this sample filter to composite the holdout image and shadow AOV over the background image.