loadIntegrationData

loadIntegrationData(participants, linkToParticipantInfo, suppressModals, mappingAttribute)

Map your own participant display data to Challonge participants for display purposes and click events. This allows you to manage your own user data and only store ids or other mappable attributes in your Challonge brackets, thus removing the need to sync updates from your system to Challonge (for example, someone changing their username in your system).

To avoid rendering the bracket until it receives integration data, add “wait=1” as a query param to our bracket embed URL.

parameter	type	description
linkToParticipantInfo	`Boolean`	For themes that support it, this enables an icon for toggling participant info. When the participant and icon are clicked, an event will be broadcast to the parent window using postMessage() with with the following data: `{ challongeEvent: "participantClick", participant: participantData{} }`
suppressModals	`Boolean`	Suppress modal windows that would normally pop up for match details, attachments, and score reporting, so you can handle the click events on your own.
mappingAttribute	`String`	The participant attribute to use when mapping your JSON data, either “display_name” (default) or “misc” (a hidden participant attribute that’s assignable via our API). In the future, “integration_uid” and “integration_roster_uids” will take over for this purpose.
participants	`JSON`	Participant data that maps the names or hidden attributes in your Challonge bracket to your own information. You can overwrite display name, icon, and hidden attributes for participants. This is useful for displaying your own player and team data without storing it in Challonge.

Participants JSON Example:

To replace participant "A" and "B" in this match:

Provide the following JSON to the "participants" parameter:

{
  "A": {
    "display_name": "Team USA",
    "portrait_url": "us-flag.svg",
    "user_id_in_your_app": 1
  },
  "B": {
    "display_name": "Team Japan",
    "portrait_url": "ja-flag.svg",
    "user_id_in_your_app": 2
  }
}

For this end result:

loadIntegrationData(participants, linkToParticipantInfo, suppressModals, mappingAttribute)#

Participants JSON Example:#

loadIntegrationData(participants, linkToParticipantInfo, suppressModals, mappingAttribute)

Participants JSON Example: