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

# Proposals

> Create energy proposals in UMS. Assess a site, prepare a draft, review the proposed options, and issue the proposal for your customer.

The Proposals module lists every assessment proposal in your organisation, newest first. A proposal starts from an assessment of a [site](https://docs.utilified.com/sites.md) and can draw on solar and battery studies from [Scenarios](https://docs.utilified.com/scenarios.md).

> [!NOTE]
>
> Proposals only appears when the Proposals module is enabled for you. Creating a proposal also needs create access to both Modelling and Proposals. Without it, the **New proposal** button is hidden. Ask an organisation admin.

## Creating a proposal

**1. Start an assessment**

Click **New proposal**. UMS opens the **New assessment** wizard.

**2. Choose the site**

Select the **Site** to assess.

**3. Set the assessment details**

Choose the **Template**, the **Baseline period** and any **Assumptions**. You can attach up to five existing studies.

Enter a **Proposal title**, or leave it blank to use the suggested one. You can change it in the editor.

## Editing a proposal

Click a row in the list to open the proposal editor. The editor has three panes:

* **Sections**: the proposal's sections. Select one to change it under **Edit section**.
* **Preview**: the proposal as it will read.
* **Section settings**: options for the selected section.

Changes save automatically. The header shows **Saving** or **Saved**.

Joule can draft narrative text from the proposal's figures. Select a section and click **Draft with Joule**. Once Joule has drafted a section, the button reads **Regenerate with Joule**. Wait for the analysis to finish before you ask it to draft. If you have already written text in a section, UMS asks before replacing it.

The **Tariff options**, **Power factor and demand** and **Solar and battery** sections list their costed options under **Options shown**. Tick the options the section presents. At least one stays shown.

## Issuing a proposal

The readiness bar shows **Ready to issue** once the proposal is complete, or lists **Warnings to resolve**. Acknowledge or fix each warning, then issue the proposal.

An issued proposal opens for anyone signed in to your organisation. A proposal shows as **Draft** until you issue it, then as **Issued**.

Once issued, the readiness bar offers:

* **Download PDF**: downloads the issued proposal.
* **Copy link**: copies a link that opens the proposal for anyone signed in to your organisation. Public client links aren't available yet.

If issuing takes longer than expected, nothing has been issued yet. Click **Issue again**.

## Related

* [Sites](https://docs.utilified.com/sites.md) — the sites you assess
* [Scenarios](https://docs.utilified.com/scenarios.md) — solar and battery studies you can attach


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.