Skip to main content

Update Leaderboard Score

The Update Leaderboard Score node submits a new score to the server and refreshes leaderboard results. It recalculates the creator’s rank and saves their highest score as their final record. Learn more about how the Update Leaderboard Score node works with Visual Scripting in the Leaderboard Object guide.

Update Leaderboard Score node

Input

NameData TypeDescription
Update ScoreExecRecalculates the user's current rank based on the latest score
Post Final ScoreExecDetermines whether the game has ended and if the score is ready to be posted
ScoreNumberThe score value to get and send to the server to determine the user's rank

Output

NameData TypeDescription
Score UpdatedExecTriggers a pulse when the score is updated
Current Friends RankNumberThe user's real-time rank among friends. This ignores previous rankings
Current National RankNumberThe user's real-time rank among all users in their country. This ignores previous rankings
Current Global RankNumberThe user's real-time rank among all users worldwide. This ignores previous rankings
Copyright © 2025 TikTok. All rights reserved.
About TikTokHelp CenterCareersContactLegalCookies