Counter-Strike 2

Counter-Strike 2

40 ratings
Uploading custom thumbnails to the Steam Workshop
By Alexandronion
This guide will show you how to upload your own thumbnail for the Steam Workshop item using SteamCMD without being restricted by the developer. For example, this works for animated GIF previews for the CS:GO workshop.
2
4
2
2
2
   
Award
Favorite
Favorited
Unfavorite
Preparing
Before the uploading, you need to do the next steps:

Step 1: Install SteamCMD
SteamCMD is a utility for working with Steam through the command line. You can download it from the official website. It also contains instructions for installing the program for different systems.

In my case, for Windows, I just downloaded a .zip file and unpacked it.

Step 2: Upload the item to the workshop
Create a new item in the workshop using the interface provided by the game developers. But it isn't necessary to make it publicly available or confirm the interest.

In my case, I uploaded the sticker to the CS:GO workshop.

Step 3: Create a thumbnail
Prepare the preview you want to set for the item. The file must be one of three types: JPG, PNG, or GIF. The system lets you using other types, however, they won't be displayed in the workshop. In addition, the file can't exceed the weight limit for a particular game.

In my case, I created an animated GIF and compressed it, because the weight limit for thumbnails in CS:GO is 1MB.
Uploading
Let's proceed uploading:

Step 1: Prepare the VDF file
Create an empty file and open it with any text editor. Fill it out using the following template:
"workshop" { "appid" "..." "publishedfileid" "..." "contentfolder" "..." "previewfile" "..." "visibility" "..." "title" "..." "description" "..." "changenote" "..." }
Where instead of ellipsis, you should enter the fields:
  • appid — ID of the game. You can find it out, for example, by going to the game page and copying from the address https://steamhost.cn/app/XXXXX the number in place XXXXX. This field is required.

  • publishedfileid — ID of the item. You can find it out, for example, by going to the page of a previously uploaded item and copying from the address https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=XXXXX the number in place XXXXX. This field is required.

  • contentfolder — path to the item. Without this field, previously uploaded item files to the workshop will remain the same.

  • previewfile — path to the preview file. This field is required.

  • visibility — value for access. If it is equal to 0 - the item will become public; 1 - the item will become available only to friends; 2 - the item will be hidden from everyone; 3 - the item will be available only through the link. Without this field, the current access won't be changed.

  • title — new name of the item. Without this field, the name will remain the same.

  • description — new item description. Without this field, the description will remain the same.

  • changenote — description of changes in the new version. Without this field, the description in the workshop will be empty after upload.
Save this file with any name and extension .vdf.

In my case, I removed all unnecessary lines and got this:
"workshop" { "appid" "730" "publishedfileid" "2944572057" "previewfile" "C:\Folder\preview.gif" }

Note: if you have any problems, try writing paths to file not with one backslash, but with two. For example: C:\\Folder\\preview.gif

Step 2: Log in to Steam via console
Run SteamCMD and when Steam> appears, enter the following line:
login <USERNAME> <PASSWORD> <STEAMGUARD>
Where:
  • USERNAME — login to your Steam account.

  • PASSWORD — password of your Steam account.

  • STEAMGUARD — Steam Guard authenticator code. If you don't have two-factor authentication on your account, you don't need to enter anything.

Step 3: Upload
Enter the following command into the console:
workshop_build_item <PATH>
Where PATH is the path to the file created in the first step.

In my case, I created a VDF file directly in the SteamCMD folder, so the path to the file consisted only of its name:
workshop_build_item file.vdf

The appearance of the inscription Success indicates that the download was finished.
Finishing
When the uploading is complete, you can go to the item page and see the result. To exit SteamCMD, close the window or type quit into the console.

In my case, I've got this item as the result:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2944572057
You can also read the official documentation on the Steam functionality described in the manual if you want.

I hope this guide was helpful, you can also ask any questions in the comments.
13 Comments
Mr. Frisby 23 Jul @ 4:17pm 
My friend, you are my HERO
Shaggoth (Ищезаяц) 2 May @ 12:41am 
steam support is a braindead monkeys it seems. they keep telling me stupid ass shit like "try another picture"
JoeOwnage 15 Feb @ 10:04am 
Amazing guide! Thanks so much! Is there a similar way to change background image?
Pollychan 10 Jan @ 12:41pm 
This is literally the only thing that works - I have no idea why it's broken like this. Instructions were simple and clear. You're a lifesaver!!
Technical Difficulties 3 Jan @ 8:50pm 
Oh my god, thank you so much for this! Not even Steam support was able to help me with this issue when I asked them.
Tranquility 28 Oct, 2024 @ 2:34pm 
TOP GUIDE! thank you!!!. it really worked! :psi:

i didn't need the
-------------------------------------------------------------------
Save this file with any name and extension .vdf.
-------------------------------------------------------------------
to be changed, it worked fine as a .txt file extension!


Steam Workshop Collection Picture Upload [SOLVED] :VBOY:
anomaluna 22 Aug, 2024 @ 5:25pm 
OMG it worked! I'd been trying so hard for so long to upload a thumbnail to my Steam workshop collection, and it just kept throwing an error.

Searched far and wide and got no solutions except finally this guide.

Cheers! ✌

To the comment below 👇 Try using double backslash to enter the address of the file as pointed out in the guide. If you already have, make sure you copied the ID of your workshop item properly when creating the .vdf file.
skaianDestiny 2 Feb, 2024 @ 7:19am 
Thank you for this, however when I tried to update my mod using this SteamCMD put out:

"ERROR! Failed to update workshop item (Access Denied)"

I can edit the workshop page fine and I've logged on properly, but it keeps giving me this error.
graphs. 19 Dec, 2023 @ 6:54pm 
just finding this now, thank you this is super helpful! :atiflames:
CN 6001 3 Dec, 2023 @ 7:24am 
im not downloding a sussy steam link you idiot