Setup guide

Create a Notion integration

This gives the widget secure, read-only permission to your content.

1. Go to notion.so/my-integrations and click New integration.
2. Name it (e.g. Instagram Grid), pick your workspace, and keep the capability set to Read content only.
3. Submit, then copy the Internal Integration Secret — it starts with ntn_. That string is your Notion token.

Prepare your posts database

Each row in this Notion database becomes one tile in your grid. Use these exact property names — they're case-sensitive.

Required properties

1. Name — Title. Your database's title column, named “Name”. The post's title.
2. Publish Date — Date. Orders the grid (newest first). The grid won't load without this property.
3. Image Source — Select with options Link, Canva, and Image Attachment. Tells the widget where to pull each tile's image from.
4. Attachment — Files & media. Upload the image here (used when Image Source is Image Attachment).
5. Link — URL. A direct image or web link (used when Image Source is Link).
6. Canva Link — URL. A Canva share link (used when Image Source is Canva).

Optional properties

1. Content Type — Select. Add options containing Reel/Video or Carousel to badge those tiles.
2. Pinned — Checkbox. Pins a post to the top of the grid.
3. Hide — Checkbox. Hides a post from the grid.

Highlights database (optional)

For the story-highlights row above the grid, create a second database with:

1. Label — Title. The highlight's name.
2. Image — Files & media (the cover), or Link — URL as a fallback.
3. Order — Number. Sets the left-to-right order.
4. Hide — Checkbox. Optional; hides a highlight.

Connect the integration to your database

Creating the integration isn't enough — you must give it access to each database.

1. Open your posts database as a full page in Notion.
2. Click the ••• menu (top-right) → Connections → Connect to, and choose your integration from Step 1.
3. Repeat for your highlights database if you created one.

Copy your database ID

1. Open the database as a full page and copy the URL.
2. The database ID is the 32-character string after your workspace name and before the ?v=. Example: notion.so/you/1a2b3c…(32 chars)?v=…
3. Copy just those 32 characters.

Create your widget

1. Open your private setup link (from your purchase confirmation email) and click + New widget.
2. Paste your Notion token, Posts database ID, and (optionally) Highlights database ID.
3. Fill in the profile — brand name, bio, avatar URL, and post/follower/following counts.
4. Choose your layout: aspect ratio (portrait or square) and number of rows; toggle the bio header and highlights.
5. Click Save widget. Repeat to add a widget for each brand or account.

Embed it in Notion

1. On your setup page, click Copy next to a widget to copy its embed link.
2. In your Notion page, type /embed and choose Embed.
3. Paste the link and press Embed link. Drag the edges to resize.

Updating & troubleshooting

Grid empty or missing posts? Check that:

1. The integration is actually connected to the database (Step 3) — the most common miss.
2. The database ID is the 32-char ID, not the view or page URL.
3. Your token is current. To replace it, edit the widget and paste a new token (leave blank to keep the existing one).