# List Builder

A device list is a simple list of  [device identifiers](/en/advertising/tools/device-identifiers/)  that lets you organize players into groups which you can then apply these lists to campaigns. (Note: Device lists are optional.)

## Types of Device Lists

-   **Inclusion Lists**  let you target a group of individual devices. Any device not in the inclusion list will not be served an interstitial or video.
-   **Exclusion Lists**  let you block a group of individual devices. Any device in this list will not be served an interstitial or video.



## Creating Device Lists

When it comes to building device lists, you have two options:

-   Leverage our Device List Builder to easily upload and manage your lists. 
-   Use the  **Edit Device List**  API to update lists on the fly. 

The identifiers you should use to build your lists are:

-   The  [IFA](/en/advertising/tools/device-identifiers/#identifier-for-advertising)  for iOS devices
	- Dashes are not inserted
	-   32 characters long
	-   Example of IFA for device lists:  `aaaaaaaabbbbcccc1111222222220000`
-   The  [GAID](/en/advertising/tools/device-identifiers/#google-advertising-id-gaid)  for Google Play devices
	-   4 dashes included
	-   32 characters long (not including dashes)
	-   Lower-case letters
	-   Example of GAID for device lists:  `aaaaaaaa-bbbb-cccc-1111-222222220000`
-   The  [Android ID](/en/advertising/tools/device-identifiers/)  for Amazon devices and older Google Play devices
	-   16 characters long
	-   Example of Android ID for device lists:  `aaabbbbccc111222`



<!--
## Using the Device List Builder

1. Navigate to the  [Device Lists section](https://platform.chartboost.com/tools/lists/device-lists). You'll see existing lists and a control panel you can use to add new ones:
2.  Enter a name for the list and pick  **iOS**,  **Android**, or  **Amazon**  from the  **Platform**  dropdown.  **You'll need to create separate device lists for each platform**, since an individual list can only contain one type of  [device identifier](/en/advertising/tools/device-identifiers/)  (you can, though, upload Android lists that include both  [GAIDs](/en/advertising/tools/device-identifiers/)  and  [Android IDs](/en/advertising/tools/device-identifiers/)).
3.  Click  **Choose File**  in the  **Select File**  field to upload your list.  **Device lists must have a .csv extension, be 50 MB or smaller** [**1**](/en/advertising/tools/list-builder/)**, and should include only a single list of identifiers separated by line breaks.** (We recommend using Excel or other spreadsheet editor to export your single column of identifiers in .csv form.
4.  Hit  **Save**, and you're done you'll see your new list appear in the page's lower section.

>**Note:** Depending on the list size, our system may need several hours to process your list before displaying the number of valid and invalid (highlighted in red) devices, and before the list is ready for use in a campaign. To overwrite, download or delete a list from your account, click the action icons in the list's  **Actions**  column.
-->


<!--
## Using Device Lists

After you've created a device list, you can apply it to your campaigns via the  **Edit Campaign**  page's  **Campaign Logic**  section:

![](https://assets.website-files.com/62cf56720f9ab3bfce19215d/62cf56720f9ab3a5331922d9_Screenshot-2020-04-06-at-15.15.37.png)

>**Note:**
>
>-  Excel has a 1 million row limitation, but you can create a text-based CSV (or use  [our API](https://platform.chartboost.com/tools/api)) if you need to add additional devices to your list
>-  Uploading a new file to an existing list will replace the original list
>-  Downloads stop working after 7 days
>-  You cannot delete lists that are currently used in active campaigns 
-->