Skip to content

Cards Overview

The Cards Overview explains the structure, content and customization options for each PNG card generated by Steam Stats. This guide assumes you have completed setup and verified that your cards appear in your README.

Steam User Summary Card

Purpose

Displays a snapshot of your Steam profile and account status.

Data Fields

  • Avatar (avatarfull): Full-size profile image
  • Name (personaname): Display name
  • Status (personastate): Online state (Online, Offline, Away, etc.)
  • Country (loccountrycode): Country code (e.g., "IN", “US”)
  • Last Logoff (lastlogoff): Last logoff Steam timestamp
  • Account Created (timecreated): Account creation timestamp
  • Current Game (gameextrainfo): Name of the game currently being played (if any)

Configuration Inputs

  • None (card layout and styling are fixed, for now)
  • Future theme support planned via action inputs

Example

Steam Profile Summary

Recently Played Games Card

Purpose

Shows games you’ve played in the last 14 days, ranked by playtime.

Data Fields

  • Game Artwork: Cover image for each title
  • Game Title: Name truncated to fit the card
  • Playtime (2 weeks): Hours played in the last 14 days
  • Optional Log Scale: Display bar lengths on a logarithmic scale

Configuration Inputs

LOG_SCALE (boolean): Should be added in workflow file

  • False (default): Linear Y-axis
  • True: Logarithmic Y-axis for improved visibility of low playtime titles

Example

Linear Scale:

Recently Played Games (Linear)

Log Scale:

Recently Played Games (Log Scale)

Workshop Statistics Card (Optional)

Purpose

Aggregates statistics for your published Steam Workshop items.

Data Fields

  • Total Subscribers: Sum of subscribers across all items
  • Total Favorites: Sum of favorites across all items
  • Unique Visitors: Sum of unique visitors

Prerequisites

  • A Custom Steam ID set in your profile
  • At least one published Workshop item

Configuration Inputs

WORKSHOP_STATS (boolean): Should be added in workflow file

  • False (default): Omit this card
  • True: Enable Workshop Stats

Combined Usage in README

Steam Stats will embed these cards in the order you place comments:

<!-- Steam-Stats start -->
<!-- Steam-Stats end -->

<!-- Steam-Workshop start -->
<!-- Steam-Workshop end -->
  • The User Summary and Recently Played cards appear within the first markers.
  • The Workshop Statistics card appears within the second markers, if enabled.

Troubleshooting Card Display

If a card is missing, verify the corresponding action input:

  • Missing User Summary Check STEAM_API_KEY and STEAM_ID
  • Missing Recent Games Check playtime data exists or disable log scale
  • Missing Workshop Ensure WORKSHOP_STATS: True and valid CUSTOM_STEAM_ID

For deeper troubleshooting, refer to the Troubleshooting Guide.

Next: Scheduling Options Workflow Configuration Details