> [!NOTE]
> **Note:** This entity is only used in metadata feeds. It isn't used with pre-election, election, or officeholder feeds.

`OfficeholderSubFeed` entities describe the attributes of an officeholder `Feed`
They specify what geographies and office levels are included and when actual
content is available in the `Feed`.

## Elements

| Element | Multiplicity | Type | Description |
|---|---|---|---|
| `DebugName` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | A descriptive name for this officeholder feed. |
| `OfficeScopeCollection` | 1 | N/A | Wrapper element for [`OfficeScope`](https://developers.google.com/civics-data/reference/office-scope) definitions that specify all of the offices being held by officeholders in this `OfficeholderSubFeed`. |
| `InitialDeliveryDate` | 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | When the partner expects to send the first draft of the feed. |
| `FullDeliveryDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | When the full list of officeholders is delivered but some attributes aren't yet finalized. |
| `ExpectedOfficeholders` | 0 or 1 | `integer` | The non-zero number of officeholders. An approximate estimate is okay. This entity can be empty if the number is unknown or if you have low confidence in the estimate. |

## Examples

The following example is a `Feed` that contains an `OfficeholderSubFeed` with
`OfficeScope`. It indicates that the `Feed` will be delivered in January 2024
and will contain the national level and state level officeholders for Australia:

### XML

```xml
<OfficeholderSubFeed>
  <DebugName>AU national and state level officeholders</DebugName>
  <OfficeScopeCollection>
    <OfficeScope>
      <DebugName>National level OH</DebugName>
      <OfficeLevel>Country</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au</JurisdictionOcdId>
      <OfficeRoles>lower house</OfficeRoles>
      <OfficeRoles>upper house</OfficeRoles>
    </OfficeScope>
    <OfficeScope>
      <DebugName>South Austria OH</DebugName>
      <OfficeLevel>Administrative Area 1</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au/state:sa</JurisdictionOcdId>
      <OfficeRoles>state lower house</OfficeRoles>
    </OfficeScope>
    ...
  </OfficeScopeCollection>
  <InitialDeliveryDate>2024-01</InitialDeliveryDate>
</OfficeholderSubFeed>
```