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

`BallotMeasureScope` entities are used to describe a ballot measure that's being
voted upon in an [`ElectionEvent`](https://developers.google.com/civics-data/reference/election-event).

## Elements

| Element | Multiplicity | Type | Description |
|---|---|---|---|
| `DebugName` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | Descriptive name used for the ballot measure. |
| `LocationLevel` | 1 | [`OfficeLevel`](https://developers.google.com/civics-data/reference/office-level) | The location level of the ballot measure: `Country` for national, `Administrative Area 1` for a state or province, etc. |
| `LocationOcdId` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | The [OCD IDs](https://github.com/opencivicdata/ocd-division-ids) of the location of the ballot measure. > [!NOTE] > **Note:** Optional if `LocationLevel` is `Country`, otherwise required. |
| `TitleOrTopic` | 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | Title of the ballot measure, if known. Otherwise, a short description of the topic. |

## Examples

The following example is a `Feed` that contains an `ElectionEvent` with
`BallotMeasureScope`. It indicates that the `Feed` contains data about a ballot
measure that will be held in California:

### XML

```xml
<BallotMeasureScope>
  <DebugName>California state Ballot measures</DebugName>
  <LocationLevel>Administrative Area 1</LocationLevel>
  <LocationOcdId>ocd-division/country:us/state:ca</LocationOcdId>
  <TitleOrTopic>Remove Voter Approval Requirement for Public Low-Rent Housing Projects Amendment</TitleOrTopic>
</BallotMeasureScope>
```