---
title: "CSBackupIsItemExcluded(_:_:)"
framework: Core Services
role: symbol
role_heading: Function
platforms: [macOS 10.5+]
path: coreservices/1443602-csbackupisitemexcluded
---

# CSBackupIsItemExcluded(_:_:)

Returns a Boolean value indicating whether an item is currently excluded from the backup.

## Declaration

```swift
func CSBackupIsItemExcluded(_ item: CFURL!, _ excludeByPath: UnsafeMutablePointer<DarwinBoolean>!) -> Bool
```

## Parameters

- `item`: The URL of the item.
- `excludeByPath`: If true, the item’s backup exclusion status applies to its location; if false, the item's backup exclusion status applies to itself, regardless of its location. See doc://com.apple.documentation/documentation/coreservices/1445043-csbackupsetitemexcluded for more information. Can be NULL.

## Return Value

Return Value true if the item or any of its ancestors are currently excluded from backup, false otherwise.

## See Also

### Managing an Item’s Backup Exclusion Status

- [CSBackupSetItemExcluded(_:_:_:)](coreservices/1445043-csbackupsetitemexcluded.md)
