# Example campaign setup

Using an example of an agency wanting to give out food packs and vouchers to residents, we will show you how to setup a campaign.

### Step 1: What should we call your campaign?

*Keep your campaign name under 30 characters.*

{% hint style="info" %}
Go to <https://admin.distribute.gov.sg> to login to the DistributeSG Admin Portal.
{% endhint %}

<figure><img src="/files/xe17MaODITq7r80hWe8F" alt=""><figcaption></figcaption></figure>

### Step 2: Do I have a list of recipients?

*If you select YES, distributors using the mobile app will be able to see if recipients are eligible.*

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Yes</strong></td><td>This means that you will be giving out food packs only to eligible residents.<br><br>You will also need to have this list of eligible people before the actual distribution takes place.</td><td></td><td><a href="/files/PsytwgqIGEHoqtn7k2Id">/files/PsytwgqIGEHoqtn7k2Id</a></td></tr><tr><td><strong>No</strong></td><td>Anyone who comes to the collection point can receive the food pack.<br><br>You do not know specifically who will be coming to collect before the actual day of the campaign.</td><td></td><td><a href="/files/XXTEOa5BB20MdJ9MDOGy">/files/XXTEOa5BB20MdJ9MDOGy</a></td></tr></tbody></table>

### Step 3: How do I identify a recipient?

*This will be how you uniquely identify an individual when he/she comes to collect the item. In addition to choosing NRIC or Address, you may also choose Unique Identifier which can support voucher numbers, ticket numbers and handphone numbers.*

{% tabs %}
{% tab title="NRIC" %}
When a recipient comes to the collection point, they will need to give their **NRIC number** to the staff at the collection point.

<figure><img src="/files/EiL5BBAlnxM4PRFjovRr" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address" %}
When a recipient comes to the collection point, they will need to give their **postal code**, followed by unit number to the staff at the collection point.

If you will be going to individual apartments, consider setting up the campaign as a Door-to-Door campaign instead.

<figure><img src="/files/PEZDHOsP4BgPmUodhQTS" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address (Door-to-Door)" %}
If you identify a recipient by his/her address, you are able to set up the campaign as a Door-to-Door campaign. **This campaign type is only applicable if you have a list of eligible households.**\
\
When the staff goes door-to-door to distribute items, they will select the unit-number from the list of eligible households.

<figure><img src="/files/TlIzfpSgnfgH11MbZLUH" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Unique Identifier" %}
If you do not want to identify the recipient by NRIC number or Address you may use **any alpha-numeric characters**. Examples include HP number, email addresses, staff number, ticket number, voucher number.

<figure><img src="/files/bCdOmVnYBSvYnN5Dc73T" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 4: Where are the locations for your distributions?

*Locations are places where your distributions will occur.*

{% tabs %}
{% tab title="NRIC, Address and Unique Identifier" %}
If you selected NRIC, Address or Unique Identifier in your previous step, it likely means that recipients will be coming to a collection point to collect these items.

**Hence, the locations you input here will be the various collection points.** For example, the different Community Centres recipients can collect the food pack.

[More locations can be uploaded once the campaign is created.](/organisers/setup-your-locations.md)

<figure><img src="/files/gMoisOOxSoZyHaRtXLtW" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address (Door-to-Door)" %}
If you selected Door-to-Door in your previous step, it means that you will be going to a recipients doorstep to deliver the items.

<mark style="color:red;">Door-to-door mode is optimised for \~30 units per location. If your location has more than 30 beneficiaries, please split your locations so that the app will not be laggy.</mark>

For example, if you are distributing items to all units in a HDB block with 12 floors, and there are 10 units per floor, you must create at least 4 locations so that each location will have a maximum of 30 units.

**Hence, the locations you input here will be sets of floors per HDB block.**&#x20;

* Blk 1 Floor 2-4
* Blk 1 Floor 5-7&#x20;
* Blk 1 Floor 8-10&#x20;
* Blk 1 Floor 11-12&#x20;

[More locations can be uploaded once the campaign is created.](/organisers/setup-your-locations.md)

<figure><img src="/files/uwopyQtO0SP7lHIkH40a" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 5: What items are you distributing?

*Use short recognisable names for your items. <mark style="color:red;">Items cannot be edited after each campaign is created.</mark>*

{% tabs %}
{% tab title="Single Quantity" %}
In this example, we will be giving residents **one food pack and one voucher**. Single quantities of each item.

Each item is listed separately and the toggle for **multiple quantities is not selected.**&#x20;

<figure><img src="/files/NuVjjWt2FfOhJmTyG6LQ" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Multiple Quantity" %}
In this example, we will be giving residents **two food packs and two vouchers**. Multiple quantities of each item.

Each item is listed separately and the toggle for **multiple quantities is selected.**

***Note:** If you want to give out only one food pack but two vouchers, you will still need to select the multiple quantity toggle.* [*The quantity of each item that a recipient is allowed to collect will be uploaded as a CSV file one the campaign is created.*](/organisers/setup-your-allocations.md)

<figure><img src="/files/U6wWnaqoHqFS2KrXnfY5" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 6: Confirm to create your campaign

*Click to create your campaign, thereafter you will be able to start adding your allocations.*

<figure><img src="/files/kR0ubi9ERMGiGI6UqqhR" alt=""><figcaption></figcaption></figure>

### Step 7: Upload allocations (i.e. "who is eligible to collect the food pack and vouchers")

*Select the right tab below based on what you chose in* [*Step 3: How do I identify a recipient*](#step-3-how-do-i-identify-a-recipient)*.*

{% tabs %}
{% tab title="NRIC" %}
If you had selected **NRIC** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), you will need to upload a list of NRIC numbers which are eligible to collect the Food Pack and Voucher.

<figure><img src="/files/or98torIQl5vJ8fImaQd" alt=""><figcaption></figcaption></figure>

Download the CSV template and fill up the allocations as shown below.

<figure><img src="/files/uqS40o21QMCtnm8UJ3yN" alt=""><figcaption></figcaption></figure>

If multiple quantity was selected in [Step 5: What items are you distributing](#step-5-what-items-are-you-distributing), fill up the quantity that each person is entitled to respectively.

<figure><img src="/files/qsFPz3OeUpk4y3wb7AmW" alt=""><figcaption></figcaption></figure>

Additional information about the items (metadata) can be added as a new column. For example if we need to ensure that the ID of each voucher is tagged to an individual, we will add a metadata column of Voucher ID. All metadata will show up in the DistributeSG mobile app for distributors.

<figure><img src="/files/aBbjp4GGnf1hhqE1W2uy" alt=""><figcaption></figcaption></figure>

Upload this file and allocations will be automatically populated.

<figure><img src="/files/ZYxTRFsz5SAugHl6aqsB" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address" %}
If you had selected **Address** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), you will need to upload a list of Postal code, floor and unit numbers which are eligible to collect the Food Pack and Voucher.

<figure><img src="/files/AG7rvXQ1fyDDdJq2k9RX" alt=""><figcaption></figcaption></figure>

Download the CSV template and fill up the allocations as shown below.

{% hint style="warning" %}
Note that DistributeSG only accepts block information (numbers and accompanying alphabets) **according to IC address** for HDB and Condo blocks. Block inputs such as 'CondoName 2' and 'CondoName Block 6' will not be accepted by the system.\
\
If there are no floor and unit numbers, please leave these columns blank.
{% endhint %}

<figure><img src="/files/vBUComk5HLkDqVedO84Z" alt=""><figcaption></figcaption></figure>

If multiple quantity was selected in [Step 5: What items are you distributing](#step-5-what-items-are-you-distributing), fill up the quantity that each person is entitled to respectively.

<figure><img src="/files/T1FoyXuHBfbXPfzJS8FQ" alt=""><figcaption></figcaption></figure>

Additional information about the items (metadata) can be added as a new column. For example if we need to ensure that the ID of each voucher is tagged to an individual, we will add a metadata column of Voucher ID. All metadata will show up in the DistributeSG mobile app for distributors.

<figure><img src="/files/hZu6ZTuayxTvxRgkWXJK" alt=""><figcaption></figcaption></figure>

Upload this file and allocations will be automatically populated.

<figure><img src="/files/pkXpj4B2F6wLaA1cOnVn" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address (Door-to-Door)" %}
If you had selected **Door-to-Door** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), you will need to upload a list of Postal code, floor and unit numbers which are eligible to collect the Food Pack and Voucher.

<figure><img src="/files/AG7rvXQ1fyDDdJq2k9RX" alt=""><figcaption></figcaption></figure>

Download the CSV template and fill up the allocations as shown below. **Note the different location names based on the recipient's floor number.** These location names were created in [Step 4: Where are the locations for your distributions](#step-4-where-are-the-locations-for-your-distributions). If you need to add more locations, check out this guide on [how to setup your locations](/organisers/setup-your-locations.md).

{% hint style="warning" %}
Note that DistributeSG only accepts block information (numbers and accompanying alphabets) **according to IC address** for HDB and Condo blocks. Block inputs such as 'CondoName 2' and 'CondoName Block 6' will not be accepted by the system.\
\
If there are no floor and unit numbers, please leave these columns blank.
{% endhint %}

<figure><img src="/files/8yuibgq8FUVLODz5kTDL" alt=""><figcaption></figcaption></figure>

If multiple quantity was selected in [Step 5: What items are you distributing](#step-5-what-items-are-you-distributing), fill up the quantity that each person is entitled to respectively.

<figure><img src="/files/NfY9xnsPpuwm5iDegaLT" alt=""><figcaption></figcaption></figure>

Additional information about the items (metadata) can be added as a new column. For example if we need to ensure that the ID of each voucher is tagged to an individual, we will add a metadata column of Voucher ID. All metadata will show up in the DistributeSG mobile app for distributors.

<figure><img src="/files/0BR9nDJXtMYqhPLaM4HM" alt=""><figcaption></figcaption></figure>

Upload this file and allocations will be automatically populated.
{% endtab %}

{% tab title="Unique Identifier" %}
If you had selected **Unique Identifier** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), you will need to upload a list of **unique alpha-numeric characters** which are eligible to collect the Food Pack and Voucher.&#x20;

<figure><img src="/files/or98torIQl5vJ8fImaQd" alt=""><figcaption></figcaption></figure>

Download the CSV template and fill up the allocations as shown below.

<figure><img src="/files/IG350ZX4o04d56r3J0gB" alt=""><figcaption></figcaption></figure>

If multiple quantity was selected in [Step 5: What items are you distributing](#step-5-what-items-are-you-distributing), fill up the quantity that each person is entitled to respectively.

<figure><img src="/files/3RT5WC9GrJ44m7Ihxz0t" alt=""><figcaption></figcaption></figure>

Additional information about the items (metadata) can be added as a new column. For example if we need to ensure that the ID of each voucher is tagged to an individual, we will add a metadata column of Voucher ID. All metadata will show up in the DistributeSG mobile app for distributors.

<figure><img src="/files/sdXSYNlQYHBsvaWCDNoM" alt=""><figcaption></figcaption></figure>

Upload this file and allocations will be automatically populated.

<figure><img src="/files/o6NkMBkbiA4ThTN6EQUP" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 8: Manage your distributors

*Distributors can join a campaign location by using a shared location code or through bulk upload of their mobile numbers by campaign administrators.*

{% tabs %}
{% tab title="Sharing of Location Code" %}
This method is used if campaign organisers **do not know the mobile numbers of distributors before the campaign date**.

\
Campaign organisers will need to share the location code which can be found in the Locations tab with distributors.

<figure><img src="/files/KcUrsd1OVlCxmeXL2Q8e" alt=""><figcaption></figcaption></figure>

Distributors will then need to key in this location code in their mobile app to join the campaign.

<figure><img src="/files/TIPN2P6DqoTQXgGzhL6E" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Bulk Upload of Mobile No." %}
This method is used if campaign organisers **know the mobile numbers of distributors before the campaign date**.\
\
You will need to upload a list of your distributors' mobile numbers.

<figure><img src="/files/LduyFoFqCLhKT0FwA8wb" alt=""><figcaption></figcaption></figure>

Download the CSV template and fill up the distributors as shown below. <mark style="color:red;">Leave the email column blank.</mark> You may add multiple location names by separating them with a comma.

<figure><img src="/files/Yrq3pw4gEJcnJWSKVXaV" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Step 9: Make your campaign active

*Activate the campaign to enable distributions.*

<figure><img src="/files/Jv0jnOBSQ5fjCfDxnYM6" alt=""><figcaption></figcaption></figure>

### Step 10: Start giving out items from the DistributeSG mobile app

{% hint style="info" %}
Download the DistributeSG mobile app from the [Apple App Store](https://apps.apple.com/sg/app/distributesg/id1546261679) or [Google Play Store](https://play.google.com/store/apps/details?id=sg.gov.distribute).
{% endhint %}

{% tabs %}
{% tab title="NRIC" %}
If you had selected **NRIC** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), distributors will be able to scan an NRIC barcode or manually key in a recipient's NRIC number.

<figure><img src="/files/lYrYUzvWqnFJg6jHWthT" alt=""><figcaption></figcaption></figure>

The app will show if a recipient is eligible.

<figure><img src="/files/FP0QltICFdip85nusJBd" alt=""><figcaption></figcaption></figure>

The distributor may add optional remarks or pictures.<br>

<figure><img src="/files/ZN7fadQDlZHBr9yXCYrp" alt=""><figcaption></figcaption></figure>

The distributor clicks Distribute and gives the items out.

<figure><img src="/files/wMhMOcXOHPg0Cx6PtrGq" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address" %}
If you had selected **Address** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), distributors will key in a recipient's postal code.

<figure><img src="/files/8umxh1O6yYfbsSImQwFy" alt=""><figcaption></figcaption></figure>

Distributors will have to key in the recipients floor and unit number.

<figure><img src="/files/5Npj9t4zoBE2RQQmSHMR" alt=""><figcaption></figcaption></figure>

The app will show if a recipient is eligible.

<figure><img src="/files/qEEgDKiWySgz1XSaTaWo" alt=""><figcaption></figcaption></figure>

The distributor may add optional remarks or pictures.

<br>

<figure><img src="/files/QHKmMXLYVuHNJMTlYJ1T" alt=""><figcaption></figcaption></figure>

The distributor clicks Distribute and gives the item out.

<figure><img src="/files/r0Yl60hieISCzNVaxzHj" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Address (Door-to-Door)" %}
If you had selected **Door-to-Door** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), distributors will be able to select from a list of eligible unit numbers.

<figure><img src="/files/ld1EbDix05sEzS25MY6d" alt=""><figcaption></figcaption></figure>

The app will show if a recipient is eligible.

<figure><img src="/files/7p3UZASm4kMaLqQYRT8Y" alt=""><figcaption></figcaption></figure>

The distributor may add optional remarks or pictures.

<figure><img src="/files/5RQ8QErRePN8qhZ3mrPG" alt=""><figcaption></figcaption></figure>

The distributor clicks Distribute and gives the items out.

<figure><img src="/files/V8Xae7YtpKHu3MGBayfs" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Unique Identifier" %}
If you had selected **Unique Identifier** in [Step 3: How do I identify a recipient](#step-3-how-do-i-identify-a-recipient), distributors will be able to scan a QR code or barcode which contains the unique identifier.&#x20;

<figure><img src="/files/hoYxqx5uR4qIOCp5SluP" alt=""><figcaption></figcaption></figure>

Alternatively, they may manually type the unique identifier in.

<figure><img src="/files/n5MEMrCtzgLZ9rsF4aH6" alt=""><figcaption></figcaption></figure>

The app will show if a recipient is eligible.

<figure><img src="/files/Z1xcv6R7VMYAu4Ayip7C" alt=""><figcaption></figcaption></figure>

The distributor may add optional remarks or pictures.<br>

<figure><img src="/files/H0vrVAKZ5koDq3MKR0sv" alt=""><figcaption></figcaption></figure>

The item is distributed out once he/she clicks Distribute.

<figure><img src="/files/fhc84KZtEJKecFAi8t8w" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% content-ref url="/pages/xzte5FQorSZ85FaWrrjF" %}
[Past campaign success](/introduction/past-campaign-success.md)
{% endcontent-ref %}

{% content-ref url="/pages/oZ5N78jPdO5rvKFFpK2Z" %}
[Create your campaign](/organisers/create-your-campaign.md)
{% endcontent-ref %}


---

# 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://guide.distribute.gov.sg/introduction/example-campaign-setup.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.