Skip to content

Upload a Score to Leaderboard

Once you have created or found a leaderboard, you can upload player scores to it.
Here’s a typical workflow in Blueprints:


Example Workflow

Uplaod Blueprint Flow

  1. Find the Leaderboard
  2. Use the Find Steam Leaderboard node.
  3. Input the Leaderboard Name you created earlier.
  4. The node returns a Leaderboard Handle on success.

  5. Upload the Score

  6. Pass the Leaderboard Handle into the Upload Score to Leaderboard node.
  7. Provide the player’s score (time, points, etc.) and choose the upload method:

    • Keep Best (Steam keeps the best score)
    • Force Update (always overwrite with the new score)
  8. Handle the Callback

  9. On success, you’ll receive confirmation that the score was uploaded.
  10. On failure, log the error or retry.

Notes

  • Make sure the leaderboard exists (either created in-game or via Steamworks Partner Site).
  • Uploading will automatically update the player’s position in the leaderboard.
  • Use Keep Best for time-attack or high-score leaderboards, and Force Update if you want the most recent score to always be shown.