# How to create a CrowdNewsroom Atlas

The CrowdNewsroom Atlas is based on the classic CrowdNewsroom. The first step, therefore, is to create a CrowdNewsroom survey. You can learn how to build your own CrowdNewsroom [here](https://wiki.beabee.io/help-center-english/engagement/crowdnewsroom/how-to-create-a-crowdnewsroom). Make sure that all the information you want to publish on the map is collected in the CrowdNewsroom.

Once you have created your CrowdNewsroom, follow these steps to enable the Atlas feature:

1. In your CrowdNewsroom, make sure you have added an *Address* field. You can find the Address in the *Advanced* field section. 

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FlMLFatm32nPchPAVu6Pc%2Fgrafik.png?alt=media&#x26;token=e657fec7-0c90-4f91-8ec6-d9eb7976c537" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**: This field captures a full address, which may contain personal data. For privacy reasons, you may choose to set this field as *Hidden*, so that the answers are not displayed publicly.
{% endhint %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FNkeRKjbxgEuArXMYZZhK%2Fgrafik.png?alt=media&#x26;token=3125ad2c-132e-4797-8707-fc3c32c91dab" alt=""><figcaption></figcaption></figure>

2. Once you have added your Address field, navigate to the *Response display* section of the CrowdNewsroom. There, you can select *Display responses publicly* and then *Enable map view of public responses*.

{% hint style="success" %}
Did you know? You can also add a Gallery display for your answers! Any CrowdNewsroom with an image-upload field can also display those images in a public gallery.
{% endhint %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FqSUnFDnjyAxxaH314e78%2Fgrafik.png?alt=media&#x26;token=da538750-6ce8-4b99-b531-70e20a958648" alt=""><figcaption></figcaption></figure>

3. Next, choose in the *Response display* section how the Atlas should be configured:

   1. The *Visible repsonse buckets* allows you to choose which responses are displayed on the map. Selecting *Inbox* will allow all responses to appear immediately after submission. If you select only *Verified*, you can filter and allow only selected responses to appear publicly.
   2. The *Response Title* is shown at the top of the response on the map, and in the gallery mode (if enabled)

   <div data-full-width="true"><figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FRu9683kZBTXTHDOkc7fN%2Fgrafik.png?alt=media&#x26;token=58d056b4-3fea-4dd3-8ea1-5483a26f5de6" alt=""><figcaption></figcaption></figure></div>

   c. If you have an image field in your CrowdNewroom, you can select that field under *Response image* for the answer display.&#x20;

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2Fad1DyGrjCk7RbxDe9k17%2Fgrafik.png?alt=media&#x26;token=5da12712-b9d3-4b86-8d70-104d9f886182" alt=""><figcaption></figcaption></figure>

{% columns %}
{% column width="50%" %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FMkwnzX2GnwWvJVNEKFqk%2Fgrafik.png?alt=media&#x26;token=1b967065-2ff6-4634-9d26-12591345d9cf" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FqguxZtuolcgo2vhxyZTX%2Fgrafik.png?alt=media&#x26;token=ba6901e5-ad45-4a60-b81e-d19b61668b22" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

4. The final step is to configure the Map settings. Go to *Response display* and then select *Map settings*.
   1. Choose the Address field that you added to your CrowdNewsroom as the field used to *plot responses on the map*.&#x20;

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FIy1kCwsSL4WstL2TKwty%2Fgrafik.png?alt=media&#x26;token=fc100ec9-1978-4db1-bddf-22381f8b9a84" alt=""><figcaption></figcaption></figure>

b. The Map Style URL will be provided to you by the beabee Support team.&#x20;

{% hint style="warning" %}
**Note:** If this is your first time building an Atlas, please write to <support@beabee.io>. The CrowdNewsroom Atlas is not a default feature for all beabee users, and may need to be enabled for your instance.
{% endhint %}

c. The Map Center, Map Bounds, and Zoom Levels are coordinates you can set to configure where geographically the map should display. You can also restrict your map to specific countries using ISO codes.

{% hint style="warning" %}
**Important:** if you have set your Address field to hidden, you can still display portions of the address in the public responses. To do this, you will need to add a Text Field to your CrowdNewsroom. You can then select that field in the section *Do you want to populate a field with the address?*.&#x20;
{% endhint %}

d. In the field below, titled *What format would you like to use?*, you can select which parts of the address should be displayed publicly. For example, {postal\_code} would only display the postal code and hide the rest of the address. You can also use the **|** symbol, which means "or". For example, the following would display the postal code + municipality OR country OR region, if one is not available in the address field: {postal\_code} {municipality|county|region}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2Fkjjxzngp0sIQeG3S65kn%2Fgrafik.png?alt=media&#x26;token=a214e796-e7bc-445e-8779-e75800c29fa4" alt=""><figcaption></figcaption></figure>

5. Finally, you can assign icons and colors to specific answer types. Please note that this is only possible for CrowdNewsroom elements with predefined answer options (e.g., drop-down, radio). Under *Select a question to display category incons on the map*, select the CrowdNewsroom element on which the icons should be based. Under Label, you can then select icons and colors for the respective answer options.

{% columns %}
{% column %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FgdjVCCqfT9gzs408q1fC%2Fgrafik.png?alt=media&#x26;token=0550e795-7a9f-4a90-9787-c66dad754c97" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://143769033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh4pciFR0eX2BaFmGVhJl%2Fuploads%2FHFamDWDZTKRMaDxjZfd5%2Fgrafik.png?alt=media&#x26;token=ff7b5bff-5cdf-4b96-8dee-c0ee4d237855" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

6. Your map is now fully configured. You can either embed the map-URL into your website or display the map as a stand-alone page in the browser.