[Guide] Using the Download Database

Avatar
msleeper
4,134 Posts
Admin
Posted Jan 19, 2026 , Edited Jan 20, 2026
Since 2007, the ThinkingWithPortals download database has been the heart of our community. Today, the database functions as a repository for user tools, materials, WIP maps, and other vital user-made content for the Portal mapping community.

This guide explains how to browse, search, and interact with files in the download database. Uploading and other file management features will be covered in the following post.


Browsing, Tags, and Filters

Files can be discovered a number of ways: browsing specific tags, filtering multiple tags, or viewing most "recently active" files.

Specific tags can be found from the main Download library page, or by clicking on a specific tag name from the list of tags when viewing a file.

You can also filter all files on the Download Database by one or more filters from the "Browse All Tags".

Lastly, you can view all files sorted by most recent activity from the "Browse All Downloads" button. This is similar to how the Forums will display active Topics.


Searching

The search bar allows you to quickly locate files.

  • Searches match file titles and descriptions.
  • Results are ranked by relevance.
  • Search can be combined with tag filters to further refine results.

Use search when you know specific keywords related to the file you want.


Voting and Ratings

Registered users can submit votes on ratings for files. A file's rating is based on an average of the votes they have received. Users are encouraged to vote on files they find useful or maps they enjoy, as a high rating helps highlight useful and high-quality files.

Each user can vote once per file, although you may change your vote at any time. Vote responsibly - ratings affect visibility and help other users decide what to download.


File Versions and Changelogs

Some files may make previous versions of files available for download. Previous versions are useful for compatibility with older setups or for troubleshooting regressions. When available, you will see a button for "View Older Versions" which will display all versions of a file available.

Files may be tagged with version info, such as "Stable", "Beta", "Deprecated", and other version tags to help you identify which version of a file you may wish to download.

A file may also include a changelog which details information between different versions. When available, you will see a button for "View Full Changelog" which will display the previous version's changelogs.


Reporting Downloads

If a file does not download correctly, does not work as described, or otherwise has issues downloading or installing, you can Report the file for manual review by the site moderators. Please reserve file Reports for major issues! If possible, you should use the file comment thread to seek assistance with the file from the uploader or file author.

To Report a broken file:

  • Use the Report Broken File option on the download page.
  • Provide a short explanation of the issue (missing file, corrupted archive, outdated content, etc.).
  • Reports notify the file author and moderators for review.

Reporting broken files helps keep the database accurate and usable.


Download Discussions

Each download has a dedicated discussion thread on the file's page. This discussion functions identically to the forum, including all Markdown and other features. Use the discussion link on the download page to ask questions, provide feedback, or report issues, as file authors may post updates, clarifications, or support information.

Download discussions are the preferred place for support and feedback related to a specific file.

Advertisement
Registered users don’t see ads! Register now!
Avatar
msleeper
4,134 Posts
Admin
Posted Jan 19, 2026 , Edited Jan 20, 2026
Replied 5 minutes later
This guide explains how to upload new files, manage existing downloads, and provide useful metadata such as tags, versions, and screenshots. These features are available to users with upload permissions.


Uploading New Files

You can upload a new file to the Download Database from the "Upload A File" button on the main Download library page.

To upload a file, you will need to input:

  • Title
  • One or more Tags
  • Description
  • Main File Upload

You may also fill out the file's Version Tag and Changelog. Although these are optional, users will find this information very useful when viewing and downloading your file.

Once submitted, the file will appear in the download listings after processing. Each uploaded file becomes its own download page with version history, screenshots, and a dedicated discussion thread.


Updating Existing Files / Adding New Versions

Existing files on the Download Database can have their information edited or be updated with new versions. If you wish to upload a new version of your file, updates are handled through Versions instead of creating a new download entry.

When you select the "Edit" button from the main download page, you will be able to modify and update the file from a similar page to the Upload page. From here you can manage the file's title, tags, description, and screenshots. You can also manage and upload new versions of your file.

Adding new versions keeps download links stable and preserves historical releases for users who need them. Older versions remain available unless you choose to remove them.


Selecting Tags

Tags help users find your file and understand its purpose. You are required to select at least one Tag for your file.

Currently there are tags for game version (Portal 1 or Portal 2), game type (singleplayer or co-op), release type such as "WIP" or "Released", and numerous tags for additional file type such as "Model", "Material", or "Script".

Avoid over-tagging - use only tags that accurately describe the file. Well-chosen tags improve search results and browsing visibility.


Version Tags and Changelogs

Each version can have its own metadata to help distinguish versions and keep users updated to changes to your files.

Version-specific tags allow you to designate specific versions as "Stable", "Beta", "Deprecated", and others. This helps users determine compatibility or release type when downloading old versions. Version tags are optional.

File versions can each have a unique changelog, describing what changed since previous versions. This may help users determine if a specific file version is right for them, and to generally follow the progress of your project, map, or file. For this reason it is recommended to keep changelogs clear and concise (bug fixes, new features, compatibility updates). Accurate version information helps users decide whether to update. Version changelogs are optional.


Uploading Screenshots

While screenshots or other images are not required for your file, you are strongly encouraged to include at least 1 image to help your file stand out. Use screenshots to demonstrate functionality, layout, or in-game appearance where applicable.

Image thumbnails appear in a gallery on your file page, and users can click on them to view the full image size.

If you have multiple screenshots uploaded, you can arrange the order from the Edit page. The first image listed is used as the thumbnail on the website. Supported image formats are listed on the upload form.


Deleting Files

In the event that you wish to delete a file from the download database, this can be done from the "Edit" page. Be aware that this action cannot be undone, and that all versions of your file will be permanently removed.