ScorecardsResults and publishingHow to
Putting a scorecard on your website
Put a scorecard in a widget, publish it and embed it on your site — and what readers see.
Applies toOwner · Admin
A scorecard stays inside your organization until you put it in a widget. There's no separate publishing step: an Owner or Admin makes a scorecard widget, publishes it, and pastes its embed code into your website. The widget shows the scorecard live, as its display options set it up.
Before you start#
- Set the display options first. The widget shows the tabs the scorecard shows, in the same order, with its saved filters, sorts and party colors. Change them on the scorecard's Review step, not in the widget. See Display options.
- Check the rationale. Every bill's public rationale appears in the widget.
- You need to be an Owner or Admin. Any Owner or Admin can put any scorecard in the organization in a widget, whoever owns it and however it's shared.
Put a scorecard in a widget#
-
Open Integration → Widgets and select New widget.
-
Give it a Name for your list of widgets. Viewers don't see it.
-
Under Topic, choose Scorecards, then choose the scorecard under Scorecard. The preview shows it as your readers will.
-
Choose what happens When a reader clicks a link. With Open details inside the widget on, a reader who selects a legislator gets their voting record and arithmetic in a panel on your page.
-
Select Publish…, read Before you publish, and select Publish widget.
-
Copy the embed code below the preview into your page. See Embedding a widget.
What readers see#
The widget always lets a reader check the scores: grades come with their bands, legislators with an insufficient record are listed rather than dropped, and the methodology is always reachable — on its own tab, or under How these scores were calculated when the scorecard doesn't show that tab. If the scorecard lets viewers change the filters, readers can open Filters; and if it offers Find my legislators, they can enter their address to see only their own legislators. See Scorecard widgets.
Keeping it current#
Scores in a widget are computed live, so new roll calls reach it on their own. Edits to the scorecard itself — its bills, positions, rules or display options — reach a published widget only when you apply them: after you save, you're asked whether to update the published widgets, and the sites they're on have the change within a few minutes of applying it. See When the scorecard changes. To take it down, select Unpublish on the widget; pages that embed it then show a short "not available" line. Deleting the scorecard deletes the widget too; the delete dialog lists it first. See Deleting something others depend on.