Finding Workshop and Collection IDs
Every Workshop item has a numeric ID in its page URL:id from the URL. You’ll use these IDs in the commands below.
Set Up a Steam Web API Key
CS2 dedicated servers may need a Steam Web API key to download Workshop content:Create the key
Go to steamcommunity.com/dev/apikey, sign in, and register a key (any domain name works, e.g.
localhost).Add it to the startup parameters
In the Wasabi Hosting Game Panel, open your server’s Startup tab and add:
Hosting a Single Workshop Map
Run this in the server console (or via RCON), replacing the ID with your map’s Workshop ID:Hosting a Workshop Collection
To run a whole collection (for example, a set of surf maps):+host_workshop_collection 123456789.
Changing Maps
| Command | Use For |
|---|---|
changelevel de_mirage | Switch to an official map already on the server |
ds_workshop_changelevel <mapname> | Switch to another map from the hosted workshop collection (by map name) |
host_workshop_map <workshopID> | Jump directly to any workshop map by ID |
ds_workshop_listmaps | List the workshop maps available in the current collection |
Map Rotation Basics
For official maps, rotation is controlled by mapgroups — named lists of maps set at startup:Keeping Maps Updated
Workshop maps are versioned by their authors. When your server restarts and loads a map viahost_workshop_map or a collection, it checks the Workshop and downloads the latest version automatically. A simple way to stay current:
- Schedule a daily restart in the Game Panel’s Schedules tab (quiet hours work best).
- Because clients also fetch maps from the Workshop, players automatically get the matching version when they join.
Troubleshooting
Map download fails or the server hangs on switch
Map download fails or the server hangs on switch
Check that your
-authkey startup parameter is set correctly and restart. Also confirm the Workshop item is public — private or friends-only items can’t be downloaded by servers.Players time out while the map loads
Players time out while the map loads
Very large maps take time on first download. Clients download from Steam themselves — ask players to wait out the transfer, and keep your server’s restart schedule off peak hours so first-downloads happen early.
ds_workshop_changelevel says the map is unknown
ds_workshop_changelevel says the map is unknown
That command only works with maps in the currently hosted collection. Use
ds_workshop_listmaps to see valid names, or host_workshop_map with the ID for maps outside the collection.Host your map pool
CS2 server hosting from €9.99/month at Wasabi Hosting — NVMe storage makes workshop downloads and map switches fast.

