Editing Lists

{{WIP}}
[[File:Lists.png|right|270px]]{{#setmainimage:Lists.png|quiet}}
'''Lists''' are user-created collections of [[User Levels|user levels]] in [[Geometry Dash]], introduced in [[Update 2.2]]. Uploaded lists can be shared with other users, while developer-approved lists reward diamonds after users complete a specified number of their levels.

Users can access lists through the Lists button in the creator menu. Users can also access the list search and creation interfaces through the Search and Create menus, respectively.

==Description==
Lists group user levels under a shared name, description, difficulty, and visual icon. They function similarly to [[Map Packs]] but are user-created, can contain varying numbers of levels, and do not normally require every included level to be completed.

Each uploaded list receives a separate list ID. Its levels appear in an order chosen by the creator, but players can select them independently rather than completing them sequentially. Individual levels retain their normal difficulty, rewards, and completion status.

===Creating and editing===
A new list can be created by opening the Create menu, switching from ''My Levels'' to ''My Lists'' and selecting ''New''. Its creator can enter a name and description, assign a difficulty, and choose an icon to represent it.<ref name="Creation">https://www.thegamer.com/geometry-dash-how-to-create-lists/</ref>

To add levels, open a user level's information page and select the list button. This displays the user's existing lists and lets them create another one. The editing interface lets users remove and rearrange included levels.

A list can also be copied, saving its selection and level order as a separate local list. When finished, the upload button publishes it to the servers. As with uploaded user levels, the title cannot be changed after publication.

===Finding and interacting===
The main Lists button displays developer-approved lists. Users can find other uploaded lists through the Search menu by switching from level searches to list searches. Users can search lists by name or ID and filter them by assigned difficulty.<ref name="Creation" />

An uploaded list displays its:
*name and description
*creator
*assigned difficulty
*list ID
*included levels and their order
*number of levels required for its reward, if approved
*diamond reward, if approved
*downloads, likes and comments

Registered users can like or dislike an uploaded list and post comments. Lists can also be shared through their list IDs. List comments use the same server system as level comments, with a list represented internally by the negative equivalent of its list ID.

===Approval and rewards===
The developer can approve a list and assign it a diamond reward. Approved lists appear through the Lists button in the online menu and are identifiable by the reward and completion requirement displayed on their information pages. Unapproved lists remain searchable but do not provide an additional list reward.

Each approved list specifies how many of its included levels must be completed. This requirement can be lower than the total number of levels in the list, allowing any sufficient selection of its levels to be used. Completing every remaining level does not provide another list reward.

After completing the required number, users must claim the diamond reward from the list page. Claiming it increases the account's list-reward statistic and counts towards the associated achievements. Attempting to claim it too early causes the [[Mechanic]] to state how many more levels must be completed.

Unlike rated user levels, an approved list does not award creator points to its creator. As of Update 2.2, [[Moderators]] also cannot send lists through the in-game level-sending interface; list requests are instead submitted separately for review by the [[Robert Topala|developer]].

===Achievements===
Seven [[Achievements|achievements]] are awarded for claiming list rewards. Only claimed rewards count; the number of diamonds received and the total number of levels completed do not determine progress.<ref name="SteamAchievements">https://steamcommunity.com/stats/322170/achievements/</ref>
{| class="wikitable" style="text-align:center;"
 !Achievement
 !Requirement
 !Reward
 |-
 |Lists?!
 |Claim 1 list reward
 |[[File:Cube246.png|50px]]<br>Cube 246
 |-
 |I'm Listening
 |Claim 10 list rewards
 |[[File:Cube173.png|50px]]<br>Cube 173
 |-
 |List-avaganza!
 |Claim 25 list rewards
 |[[File:Ball052.png|50px]]<br>Ball 52
 |-
 |Listen to me!
 |Claim 50 list rewards
 |[[File:Ship140.png|50px]]<br>Ship 140
 |-
 |Lists! Lists everywhere!
 |Claim 100 list rewards
 |[[File:Ball096.png|50px]]<br>Ball 96
 |-
 |List Whisperer
 |Claim 150 list rewards
 |[[File:Wave089.png|50px]]<br>Wave 89
 |-
 |200 Lists, 1 Legend
 |Claim 200 list rewards
 |[[File:Swing039.png|50px]]<br>Swing 39
|}

===Geometry Dash Lite===
The standard Lists button is not present in [[Geometry Dash Lite]]. It is replaced by the ''Bonus'' tab, which provides a rotating selection of ten Platformer levels. The developer selects these levels, and they do not function as ordinary user-created lists.

==Trivia==
*Lists were announced as part of Update 2.2 and released with the update on 19 December 2023.
*Unlike Map Packs, lists do not award secret coins.
*An approved list can contain unrated levels.
*The difficulty assigned to a list describes the collection rather than changing the ratings or rewards of its individual levels.
*The same user level can appear in multiple uploaded lists.
*List rewards count only when manually claimed. Simply meeting the completion requirement does not advance list-reward achievements.
*List comments are stored through the level-comment system using the negative equivalent of the list ID.

==References==
<references />
[[Category:Gameplay (base content)]]