> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Volume contracts

> Create, allocate, and retire renewable energy contracts and RECs in EnerG

Create, allocate, and retire volume-based emission contracts in EnerG. Expand **Emissions** in the left sidebar and open **Contracts** to record <Tooltip tip="Renewable energy certificate: a tradable attribute representing renewable generation that can be allocated and retired.">renewable energy certificates (RECs)</Tooltip>, offsets, and other instruments that reduce or attribute emissions. Reach this page from the [portfolio view](/products/energ/get-started/navigation#portfolio-view) or the [building view](/products/energ/get-started/navigation#building-view) after you select a site. For how instruments affect emissions, see [RECs and offsets](/products/energ/concepts/emissions-accounting#recs-and-offsets).

## Navigate to Volume Contracts

Click `Emissions` > `Contracts` in the portfolio left sidebar.

<Frame caption="Volume Contracts page with search, filter, and contracts table">
  <img src="https://mintcdn.com/kodelabs/euAGYgyin2AxlZ4b/images/energ/energ-portfolio-emissions-volume-contracts.png?fit=max&auto=format&n=euAGYgyin2AxlZ4b&q=85&s=ca29f29da2a4991b42ba20e4f82344da" alt="Volume Contracts page with Search field, Filter button, Create Contract button, and table showing contract name with Allocate action, contract type, procurement method, status, coverage, and total volume for REC contracts such as MISO_REC_Offset_Companion_2025" width="1024" height="334" data-path="images/energ/energ-portfolio-emissions-volume-contracts.png" />
</Frame>

Click `+ Create Contract` in the top right to add a new agreement. Use **Search** to find contracts by name and click `Filter` to narrow the list by status, type, or reporting year. For the columns in the contracts table, see [volume contract fields](/products/energ/reference/emissions-reference#contract-fields).

## Allocate contract volume

Click **Allocate** on a contract row to distribute **Total Volume** across buildings or time periods. When **Allocated** equals **Total Volume** and **Remaining** is `0 kWh`, the contract is fully assigned.

## Retire a contract

Each contract row includes actions on the right side of the table, after **Document URL**.

| Action     | Purpose                                                                                 |
| ---------- | --------------------------------------------------------------------------------------- |
| **Retire** | Retire environmental attributes so they count toward offsets and market-based reporting |
| **Delete** | Remove the contract from the library                                                    |

<Frame caption="Retire action on a volume contract with Pending retirement status">
  <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-portfolio-emissions-contract-retire.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=1b07ec51fd256758270f6f25f27fee24" alt="Volume contract table row showing Pending retirement status badge, Retire tooltip on the retire icon, and delete trash icon in the row actions column" width="417" height="214" data-path="images/energ/energ-portfolio-emissions-contract-retire.png" />
</Frame>

Contracts with **Pending retirement** in the **Retirement Status** column are not yet retired. Click **Retire** to complete retirement. After retirement, **Retirement Status** updates and REC volume appears in offset charts on [Emissions overview](/products/energ/analytics/portfolio-emissions-overview).

<Note>
  Confirm **Retirement Status** before you report market-based <Tooltip tip="Indirect greenhouse gas emissions from purchased energy such as electricity and district steam.">Scope 2</Tooltip> emissions. Retired REC volume rolls into offset and renewable charts on [Emissions overview](/products/energ/analytics/portfolio-emissions-overview).
</Note>

## Create a contract

Click `+ Create Contract` to open the **Create Contract** panel on the right. The panel subtitle reads *Add a renewable energy instrument.*

<Frame caption="Create Contract panel with Contract Details fields">
  <img src="https://mintcdn.com/kodelabs/Ph3_DUgZdP7vM-lt/images/energ/energ-portfolio-emissions-create-contract.png?fit=max&auto=format&n=Ph3_DUgZdP7vM-lt&q=85&s=00180e3cd3c610c4ca28953af537332b" alt="Create Contract side panel with Contract Name Market Country Region State Contract Type Procurement method Energy Source Total Volume and Unit fields, and Close and Submit buttons" width="1024" height="687" data-path="images/energ/energ-portfolio-emissions-create-contract.png" />
</Frame>

<Steps>
  <Step title="Enter contract details">
    Fill in **Contract Name**, **Market**, **Country**, **Contract Type**, **Energy Source**, **Total Volume**, and **Unit**. Add **Region / State** and **Procurement method** when they apply. **Country** activates after you choose **Market**, and **Region / State** activates after you choose **Country**.
  </Step>

  <Step title="Set factors and reporting years">
    Enter **Vintage Year** and **Applicable Reporting Year**. Adjust **Emission Factor** and **Emission Factor Unit** when the contract includes a linked factor.
  </Step>

  <Step title="Add dates and documentation">
    Set **Contract Start** and **Contract End** for the agreement window. Enter **Registry / Counterparty**, **Serial Numbers**, **Document URL**, and **Notes** when you have audit evidence.
  </Step>

  <Step title="Submit the contract">
    Click `Submit` to save the contract. Click `Close` to exit without saving.
  </Step>
</Steps>

For the full list of contract fields, see [volume contract fields](/products/energ/reference/emissions-reference#contract-fields).

After you create the contract, click **Allocate** on the row to assign volume to buildings. Use **Retire** when **Retirement Status** is `Pending retirement` and you are ready to count attributes in offset reporting.

<Tip>
  Fully allocate active REC contracts so **Remaining** reaches zero before period close. Unallocated volume does not attribute renewable energy to buildings in benchmarking or overview rollups.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Emissions accounting" icon="cloud" href="/products/energ/concepts/emissions-accounting" arrow={true} cta="Read">
    Understand RECs, offsets, and market-based Scope 2.
  </Card>

  <Card title="Emissions reference" icon="table" href="/products/energ/reference/emissions-reference" arrow={true} cta="Look up">
    Look up the full volume contract field list.
  </Card>

  <Card title="Building emissions overview" icon="cloud" href="/products/energ/buildings/emissions-overview" arrow={true} cta="Open">
    Review GHG charts and scope tables for one building.
  </Card>

  <Card title="Portfolio emissions overview" icon="cloud" href="/products/energ/analytics/portfolio-emissions-overview" arrow={true} cta="Open">
    Review offset breakdown and renewable contract rollups.
  </Card>

  <Card title="Emission factors" icon="book-open" href="/products/energ/analytics/portfolio-emissions-emission-factors" arrow={true} cta="Open">
    Manage factors used alongside contract attributes.
  </Card>

  <Card title="Emissions benchmarking" icon="chart-column" href="/products/energ/analytics/portfolio-emissions-benchmarking" arrow={true} cta="Open">
    Compare building emissions after contracts are allocated.
  </Card>
</CardGroup>
