This guide walks you through connecting your Notion database to Trope Map and making the most of every feature. Initial setup takes about ten minutes. After that, the widget stays in sync automatically—publish a book in Notion and it appears on next refresh.
Go to notion.so/my-integrations and click New integration. Name it “Trope Map Widget”, select the workspace your book database lives in, and save. Leave capabilities at their defaults—read access is all the widget needs.
Copy the Internal Integration Token once it's created. Keep it somewhere safe—you'll paste it into the widget editor in Step 4.
| Property name | Type | Notes |
|---|---|---|
| Title | Title | Book title—required |
| Author | Text | Required for reliable cover matching |
| ISBN | Text | Optional—exact-edition cover override optional |
| Cover URL | URL | Optional manual override; wins over auto-resolved covers optional |
| Series | Text | Leave blank for standalones |
| Series Number | Number | Position within the series |
| Trope Tags | Multi-select | The filter taxonomy—one chip renders per option with ≥1 book |
| Spice Level | Select | Options 1–5. Select, not number, so blank means “not yet rated” |
| Blurb | Text | Shown in the lightbox |
| Status | Select | Published, Pre-Order, Coming Soon, Archived. Archived is always excluded |
| Widget Visible | Checkbox | Default checked—uncheck to hide without deleting |
| Widget Order | Number | Manual override for standalone sort order optional |
Trope Tags starter list: the taxonomy is fully author-editable—add, remove, or rename options in Notion any time. The widget only ever shows chips for tags with at least one book.
Add one URL property for each retailer you sell on—the property name must match exactly:
You don't need every retailer. Any property that's blank or missing is simply ignored—the widget never shows an empty button.
Open your book database in Notion. Click the ··· menu, then Connections → Connect to → select the integration you created in Step 1.
Open the database as a full page. The URL looks like notion.so/YOUR-WORKSPACE/abc123def456...?v=...—the database ID is the 32-character string between the last / and ?v=.
On your setup page, click New widget. Give it a name, paste your Notion integration token and database ID, choose a theme, and save. Your embed URL and iframe snippet appear on the widget card.
Trope taxonomy overrides optional—a JSON map to rename chip labels without editing Notion, e.g. {"Enemies to Lovers": "Enemies-to-Lovers"}.
Affiliate tags optional—enter your Amazon, Bookshop.org, and Kobo affiliate IDs once; the widget appends them automatically to every matching retailer link.
/embed and select Embed.Copy the iframe snippet from your widget card and paste it into a WordPress Custom HTML block, a Squarespace Code block, an Elementor HTML widget, or anywhere else that accepts HTML.
Widgets default to dark. Add &theme=light to the embed URL for a version that blends into any page.
Make sure at least one row has Widget Visible checked and Status is not Archived.
The most common cause is that your Notion integration hasn't been connected to the database. Open the database → ··· → Connections → Connect to → select your integration.
The URL property name in Notion must match exactly, including capitalization and spacing—check against the list in Step 2.
Use the recovery form if you've lost your setup link, or reach out for help.