Voting is the mechanism by which users signal the quality and relevance of posts and comments on Artemis. Every logged-in user can cast one vote — up, down, or rescind — on each votable item. Votes feed directly into ranking algorithms and accumulate as karma on the author’s account. This page explains how votes are cast, how karma is counted, how the hot algorithm works, and how gold awards relate to community recognition.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/artemis-development-group/artemis/llms.txt
Use this file to discover all available pages before exploring further.
How voting works
Each post and comment displays an upvote arrow, a score, and a downvote arrow. Clicking the upvote arrow casts an upvote (direction: 1); clicking downvote casts a downvote (direction: -1). Clicking the active arrow again removes your vote (direction: 0).
Internally, the Vote model stores three directions:
| Direction | Serialized value | Meaning |
|---|---|---|
up | 1 | Upvote |
down | -1 | Downvote |
unvote | 0 | Removed vote |
Voting via the API
| Parameter | Type | Description |
|---|---|---|
id | string | Fullname of the post or comment (e.g. t3_abc123 for a post, t1_xyz789 for a comment) |
dir | integer | Vote direction: 1 (up), -1 (down), or 0 (remove) |
rank | integer | Optional. The rank of the item in the listing at time of vote, used for analytics. |
Voting requires authentication. The API follows standard OAuth2 token authentication — include your
Authorization: Bearer <token> header.Karma
Karma is a running total of the community’s response to your contributions. It is split into two types, both stored as integer fields on theAccount model.
| Karma type | Field | What increases it |
|---|---|---|
| Link karma | link_karma | Net upvotes on posts (links) you submitted |
| Comment karma | comment_karma | Net upvotes on comments you wrote |
/user/:username/about.
Score and ranking
A post’s visible score is the sum of its upvotes minus its downvotes. The raw score is used as input to sorting algorithms.Hot algorithm
The hot sort — the default listing — weighs both a post’s score and its age. Older posts decay in rank even if they continue receiving votes, giving newer posts with momentum a chance to appear at the top. The algorithm is applied server-side when building the hot listing at/hot or /r/:branchname/hot.
Other sorts and vote influence
| Sort | How votes factor in |
|---|---|
new | Votes not considered; strictly chronological |
top | Sorted by raw score descending |
controversial | Posts with high total vote count but close upvote/downvote ratio rank highest |
rising | Posts gaining votes quickly relative to their submission time |
Vote fuzzing
Artemis fuzzes the displayed vote count on posts and comments to deter targeted vote manipulation. The displayed score is close to — but not exactly — the true score. This is transparent to end users but means you should not rely on the displayed score for exact counts.Gilding
Gold awards are a way to recognize exceptional posts or comments beyond an upvote. Any user with gold credits can gild any post or comment.Find content worth gilding
Any post or comment can be gilded. Click the gold icon (trophy) beneath the item.
Confirm the award
A confirmation dialog appears showing the cost in gold credits. Confirm to proceed.
/r/:branchname/gilded— gilded posts and comments in a branch/gilded— site-wide gilded feed/comments/gilded— gilded comments across the site
gilding_server_seconds field on the Branch model.