WordPress Integration Guide

Everything you need to add SchoolDigger widgets to your WordPress site. Find school IDs, generate shortcodes, customize styles, and preview widgets — all from this page.

Download Plugin (v1.0.5) Sign Up Free See Demos
On This Page

Setup Guide

Get widgets running on your WordPress site in 5 steps:

1
Create a Free Account

Sign up at widgets.schooldigger.com/signup. You'll get an App ID immediately.

2
Install the WordPress Plugin

Download schooldigger-widgets-1.0.5.zip

Upload via Plugins > Add New > Upload Plugin in your WordPress admin, then activate.

3
Enter Your App ID

Go to Settings > SchoolDigger Widgets in your WordPress admin and paste your App ID. You can find it in your SchoolDigger dashboard under Integration > API Keys.

4
Add Your Domain

Add your WordPress site's domain to the domain whitelist in your SchoolDigger dashboard. The domain must match exactly (e.g., www.yoursite.com).

Widgets won't load if your domain isn't whitelisted. This is a security measure to prevent unauthorized use.
5
Add Widgets

Use the shortcode or the Gutenberg block:

  • Shortcode: Paste [sd_widgets widget="school-info-card" school-id="SCHOOL_ID"] into any page or post
  • Gutenberg Block: Search for "SchoolDigger" in the block inserter, select the widget type, and configure parameters

School & District ID Lookup

Many widgets require a School ID or District ID. Search below to find the IDs you need.

Shortcode & Embed Code Generator

Select a widget, configure options, and get ready-to-paste code for your WordPress site.

Widget Configuration
Live Preview

Select a widget type and configure options to see a preview

Widget Quick Reference

All available widgets at a glance. Click a widget name for full documentation.

Widget Shortcode widget= Tier Required Example Shortcode
School Information Card school-info-card Free school-id [sd_widgets widget="school-info-card" school-id="YOUR_SCHOOL_ID"]
District Information Card district-info-card Free district-id [sd_widgets widget="district-info-card" district-id="YOUR_DISTRICT_ID"]
Ranking Badge ranking-badge Basic school-id [sd_widgets widget="ranking-badge" school-id="YOUR_SCHOOL_ID"]
School Finder school-finder Basic none [sd_widgets widget="school-finder"]
Test Score Chart test-score-chart Pro school-id [sd_widgets widget="test-score-chart" school-id="YOUR_SCHOOL_ID"]
School Autocomplete school-autocomplete Basic none [sd_widgets widget="school-autocomplete"]
District Autocomplete district-autocomplete Basic none [sd_widgets widget="district-autocomplete"]
Top Schools List top-schools-list Basic state, level [sd_widgets widget="top-schools-list" state="NY" level="..."]
Nearby Schools Map nearby-schools-map Pro center-mode [sd_widgets widget="nearby-schools-map" center-mode="..."]
Tip: You can add any data attribute as a shortcode attribute using kebab-case. For example, the data attribute data-show-address="true" becomes the shortcode attribute show-address="true". See the full documentation for all available attributes per widget.