# How to Create a Proposal

## 📝 How to Create a Proposal

### Preparation

There will naturally be some forum topics that evolve into new proposals on the DAO platform for voting ([https://dao.projectserum.com](https://dao.projectserum.com/)).&#x20;

{% hint style="info" %}
You can read the Governance Rules and Guidelines [here](https://docs.projectserum.com/guides/governance). The expectations for transforming forum topics into proposals are explained there.
{% endhint %}

To start, please access the **DAO GUI** [here](https://dao.projectserum.com).

Currently, the minimum amount of SRM you need to hold to create a new DAO proposal for voting is 25K SRM.

{% hint style="success" %}
This amount is configurable via voting. The SRM is *not* spent upon creating a new proposal.
{% endhint %}

Select the **governance** you wish to participate in under the relevant **realm**.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2F0mVybrvLDHzRTJXrMcEx%2Fimage.png?alt=media\&token=baf0193e-ccc0-48ee-a67f-47962acf08af)

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2Fu8tQySdaEShGb64DwvkV%2Fimage.png?alt=media\&token=ad69918b-c4ed-49e2-8ba0-6daae00054b3)

{% hint style="info" %}
A **governance** is an address governed by the DAO (e.g. a token account or program upgrade authority).

A **realm** is an instance of a DAO.
{% endhint %}

###

### Add a New Proposal

Click on “**Add new proposal**” to get started.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FdhkMJukMVIGHOTPF5LW8%2Ftelegram-cloud-photo-size-1-4961144383655226055-y.jpg?alt=media\&token=99c97c12-f3ff-4707-81de-c2f4e0cc8535)

Next, you will need to deposit the tokens into the program using the "**Deposit Governance Tokens**" button.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2F5Q9SFYTZxsMyxnSly2ve%2Ftelegram-cloud-photo-size-1-4958892583841540770-x.jpg?alt=media\&token=6234f167-2a61-4dfd-9593-f89bf2c93fd4)

{% hint style="warning" %}
Note: You can withdraw the SRM immediately after creating the proposal.
{% endhint %}

If you do not place tokens into the program first, you will not be able to add a new proposal.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FrYb2KlWJNO5XAbD3UTMB%2Ftelegram-cloud-photo-size-1-4958892583841540771-x.jpg?alt=media\&token=19b59862-8bec-42e6-9eba-5a1603b5f666)

Next, you will need to ***specify the voters*** for your proposal.&#x20;

For example, you can specify that your proposal is to be voted by the **Community Token Holders**.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FDfabpS36WmUyZzwS7mLM%2Ftelegram-cloud-photo-size-1-4958892583841540772-x.jpg?alt=media\&token=98c49d89-956c-4bbd-a302-10001f4a3548)

### Populating the Proposal

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FcqQBRdplq7SW05lMdW5c%2Ftelegram-cloud-photo-size-1-4958892583841540773-y.jpg?alt=media\&token=cdb7833b-df7b-4fa9-bfae-0d852eaf821c)

To populate the description with text, you can use a [**Github gist**](https://docs.github.com/en/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists).

You can read the “creating a gist” section of this guide to learn more.

A gist is basically just a little webpage that displays the text. Once you create it, you can paste the link into the DAO UI and the UI will auto-populate with the content.

![Be sure to share the link, not embed it!](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FyaImqTHce66j5KBSUF5a%2Ftelegram-cloud-photo-size-1-4958892583841540774-x.jpg?alt=media\&token=78ea4d2d-1e5c-4b17-add8-d4a4a40bad69)

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FdYStimRZVb6duhzCcuiH%2Ftelegram-cloud-photo-size-1-4958892583841540775-y.jpg?alt=media\&token=7fbeb819-ae06-4f41-b5af-ac957f096fd0)

### Adding Instructions to the Proposal

Now, you need to enter instructions, or instruction data associated with the proposal. When you create the proposal, there should be an **instruction page**.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FJU4ViLF9DoXL4sitORZO%2Ftelegram-cloud-photo-size-1-4958892583841540776-x.jpg?alt=media\&token=39341979-6e04-4876-9fb9-11a479032d11)

Click the + button on the bottom right next to the "**instruction**" box to add instruction fields.

![](https://593228139-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX0KCPgI-ecLKfYa3jX%2Fuploads%2FInbyE8eexH3TB8PSGw1N%2Ftelegram-cloud-photo-size-1-4958892583841540777-x.jpg?alt=media\&token=e2431ed3-fe9b-4ad9-bec0-3ed2e71f1a25)

You would need to replace the numbers above with your own, of course.

Under “**spl-token transfer**”, you do not need to add any instructions.

Select “**set-governance-coding**” and change the parameters you want.

{% hint style="info" %}
The yes vote threshold cannot be smaller than 1%. (This is configurable via voting of course!).
{% endhint %}

{% hint style="info" %}
Changing the parameters here does not update these parameters across the DAO. These fields represent the proposal to update the DAO accordingly.
{% endhint %}

For example, if one wanted to change the maximum voting time to X days, they can input X into the relevant field and leave the rest unchanged.

In accordance with the DAO’s [Rules and Guidelines](https://docs.projectserum.com/guides/governance), you must propose what your corresponding forum post says.

### Ship Proposal

It’s now time to ***ship your proposal***.&#x20;

When you click **Sign Off**, the proposal will be out there for people to vote on. There is also a button to add signatories.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.projectserum.com/guides/governance/how-to-create-a-proposal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
