Syncing League Data

The Sync page at Commissioner → Sync League Data is how league data gets into the app. It has two tabs: Settings, for the values the automatic jobs use, and Sync, for running syncs and imports yourself. Every operation is safe to re-run; nothing gets duplicated.

Settings Tab

This Season's Sleeper League ID

Sleeper issues a new league ID every season. The nightly automatic sync starts from this ID and walks back through every previous season.

Update this each year when Sleeper rolls the league over. If it's blank, the nightly sync does nothing.

• Find the ID in the Sleeper app under League Settings, or in the league's web URL.
• Paste it and click Save.

Extra Live Game Dates

The live leaderboard and the fast score refresh only treat Thursday through Monday as game days. If the NFL schedules a game on another day, such as a Wednesday opener, add that date here so live scores update.

• Enter dates as YYYY-MM-DD, separated by commas (Eastern time).
• Remove a date once that week's games are over.

FantasyPros API Key

Used by the FantasyPros breaking-news alerts posted to Discord. The free tier allows 50 calls a day. If no key is saved here, the app falls back to the server's environment setting, if any.

Sync Tab

Sleeper Sync

What it syncs: every season linked through Sleeper's league chain, including:

• league settings
• managers and rosters
• weekly matchups and lineups
• transactions
• drafts
• player stats

The NFL player database (names, teams, injury status) is not part of this sync. It updates on its own every night.

Steps:

1. Go to the Sync tab.
2. The Sleeper League ID defaults to the active league ID. Paste a different one to sync another league chain.
3. Click the sync button.

The sync runs in the background, so the page returns right away with a "queued" message. A full multi-season sync can take a few minutes. Refresh the season page afterward.

When You Need to Sync Manually

You rarely do. The app syncs on its own:

Sync manually after a major change, such as a new season's league ID, or if something looks out of date.

Importing Yahoo Historical Data (2018)

The 2018 season was played on Yahoo. Importing it requires a one-time authorization through a Yahoo Developer app.

First import:

1. Create an app at Yahoo Developer to get a Client ID and Client Secret.
2. Enter the Client ID and click Get Auth URL. The URL appears in the output box at the top of the page.
3. Open that URL, sign in to Yahoo, and copy the verification code it shows.
4. Paste the code into Auth Code, along with the Client ID and Secret.
5. Click Import.

The league ID, game key (380 = 2018), season year and number of weeks are pre-filled.

Later imports: the app saves the Yahoo token, so you can import again without credentials. If the token has expired, enter the Client ID and Secret to refresh it.

The import's output, or any error, appears in the output box at the top of the page.

Importing ESPN Historical Data (2015–2017)

What it imports: standings, matchups and team data for 2015, 2016 and 2017.

ESPN private leagues require two authentication cookies from your browser.

Steps:

1. In the ESPN section of the Sync tab, enter:
2. ESPN League ID, found in the ESPN URL: fantasy.espn.com/football/league?leagueId=XXXXXXX
3. SWID Cookie, a shorter identity token from your browser
4. espn_s2 Cookie, a long authentication token from your browser
5. Click Import ESPN. The import runs while you wait, and the output appears at the top of the page.

Getting Your ESPN Cookies

You must be logged in to ESPN in your browser. The cookies are in your browser's developer tools.

Chrome or Edge:

1. Go to espn.com and log in.
2. Press F12 to open DevTools and go to the Application tab.
3. Under Storage → Cookies, click https://www.espn.com.
4. Find espn_s2 and SWID and copy their values.

Firefox:

1. Go to espn.com and log in.
2. Press F12, then open Storage → Cookies → https://www.espn.com.
3. Copy the espn_s2 and SWID values.

Safari:

1. Enable the Develop menu: Safari → Settings → Advanced → check "Show Develop menu."
2. Go to espn.com and log in.
3. Open Develop → Show Web Inspector → Storage → Cookies.
4. Copy espn_s2 and SWID.

Keep these values private. Anyone with your ESPN cookies or Yahoo credentials can access your account.

Re-importing

Re-running the ESPN or Yahoo import is safe. Existing records are updated, not duplicated, which is useful after correcting manager links.

Deploy Order on a Fresh Install

Set up the Discord webhook after syncing and importing. When a webhook is saved for the first time, the app marks the current season's existing trades as already announced, so the channel isn't flooded. See Discord Integration.

Unknown Accounts After Sync

After syncing, the Manager Accounts page may show an Unknown Accounts section. These are teams whose owner couldn't be identified, usually because:

• A manager left mid-season, so there's no Sleeper user on the roster.
• An ESPN or Yahoo team changed owners mid-season.

Their stats are kept in full. See Managing Accounts for how to name them.