NotionX/react-notion-x

View on GitHub

Fast and accurate React renderer for Notion. TS batteries included. ⚡️

Stars: 5.4k
Forks: 645
Open beginner issues: 0
Indexed issues: 146

Dominant language: TypeScript
License: MIT
Last GitHub push: Sep 19, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: help wanted good first issue
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

146 open issues indexed

notion-client requests now 403 (Cloudflare) because no User-Agent is sent — workaround: pass one via ofetchOptions Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

NotionX/react-notion-x#710 · 4 comments · 15 reactions · Opened Aug 4, 2026
Video blocks prefer fixed block_height over responsive aspect ratio Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

NotionX/react-notion-x#708 · Opened Jun 30, 2026
File uploads page in example fails to load PDF Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

NotionX/react-notion-x#686 · 1 comment · Opened Mar 4, 2026
loadPageChank Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

NotionX/react-notion-x#675 · 1 comment · Opened Oct 26, 2025
getPageTableOfContents() not getting headers inside Callouts Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

NotionX/react-notion-x#667 · Opened Sep 25, 2025
Public Notion Page not detected as public because missing ID in URL Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

NotionX/react-notion-x#647 · 1 comment · 1 reaction · Opened Jul 7, 2025
Feature request: Twitter emojis by default Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#644 · Opened Jun 17, 2025
Support for hyperlinks attached to images Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

NotionX/react-notion-x#637 · 5 comments · 1 reaction · Opened May 30, 2025
How to custom CollectionCard Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

NotionX/react-notion-x#621 · Opened Apr 9, 2025
Suggest Edits markup appears in rendered text Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

NotionX/react-notion-x#619 · 4 reactions · Opened Mar 25, 2025
Login Failure in NotionAPI Active User Settings to access Private Page Open

Difficulty 3/5 1-2 days Newbie friendliness 28/100

NotionX/react-notion-x#611 · 2 comments · Opened Feb 15, 2025
feat-request: Is it can be used for editing in the future? Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

NotionX/react-notion-x#606 · Opened Jan 29, 2025
Feature Request: Add Support for Notion Forms Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#605 · 4 reactions · Opened Jan 13, 2025
Compatibility Issue with react-lazy-images and React 19 Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

NotionX/react-notion-x#601 · 8 reactions · Opened Jan 11, 2025
Feature Request: mapVideoUrl Utility Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

NotionX/react-notion-x#597 · Opened Dec 16, 2024
Search dialog could spin infinitely Open

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

NotionX/react-notion-x#593 · Opened Nov 28, 2024
getPageBreadcrumbs() result does not include collection parent page Open

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

NotionX/react-notion-x#587 · Opened Nov 19, 2024
I encountered a problem about compilation failure, but I don't know what the reason is. I hope someone can help me, thank you! Open

Difficulty 4/5 3-5 days Newbie friendliness 20/100

NotionX/react-notion-x#584 · Opened Nov 13, 2024
Search returns no result Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#583 · Opened Nov 12, 2024
PDF file URLs won't be signed Open

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

NotionX/react-notion-x#580 · 4 comments · 1 reaction · Opened Nov 8, 2024
Add Custom Emoji Block Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#577 · 2 comments · 5 reactions · Opened Nov 5, 2024
NaN Error When Using Next.js Image Component Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#562 · Opened Oct 1, 2024
Interface Collection in notion-types is not correcet? Open

Difficulty 2/5 1-3 hours Newbie friendliness 42/100

NotionX/react-notion-x#557 · Opened Jul 31, 2024
Adding the option to show latex code when clicking equation blocks Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

NotionX/react-notion-x#552 · Opened May 6, 2024
Mirror Notion in hiding block_width "0" assets Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

NotionX/react-notion-x#550 · Opened Apr 19, 2024
Next.js App Router Customer Image Component Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

NotionX/react-notion-x#549 · 3 comments · 1 reaction · Opened Apr 17, 2024
Broken link in NotionRenderer breadcrumb Open

Difficulty 3/5 1-2 days Newbie friendliness 38/100

NotionX/react-notion-x#539 · Opened Feb 2, 2024
Private Page: d.map is not a function Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

NotionX/react-notion-x#535 · Opened Jan 17, 2024
notion-client not supported with bun Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#532 · 1 comment · Opened Nov 19, 2023
Attempt to rewrite and execute renamed hash links - need advice Open

Difficulty 5/5 Over a week Newbie friendliness 20/100

NotionX/react-notion-x#527 · Opened Oct 26, 2023
Unsupported type copy_indicator Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#522 · 1 comment · Opened Oct 2, 2023
Embed component video attachment file got error AccessDenied when showed Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

NotionX/react-notion-x#520 · 10 comments · 10 reactions · Opened Sep 21, 2023
notion h tag series not being new line when using multiple h tags in a row Open

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

NotionX/react-notion-x#517 · 2 comments · Opened Sep 20, 2023
"notion-yt-playbtn" style is missing Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#516 · Opened Sep 14, 2023
Toggle Heading Width causing misalignment on smaller screens Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

NotionX/react-notion-x#513 · Opened Aug 22, 2023
<pre> tag content is sometimes not displayed in GUI Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#503 · 2 comments · Opened Jun 28, 2023
Warning: Expected server HTML to contain a matching <div> in <a>. Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

NotionX/react-notion-x#501 · 1 comment · 1 reaction · Opened Jun 24, 2023
Hydration Error: validateDOMNesting(...): <a> cannot appear as a descendant of <a>. Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#492 · 2 comments · Opened May 30, 2023
Alternative that works well with Remix? Open

Difficulty 5/5 Over a week Newbie friendliness 15/100

NotionX/react-notion-x#490 · 2 comments · Opened May 26, 2023
Pre-rendering pages on Github Actions causes 403 Error Open

Difficulty 4/5 3-5 days Newbie friendliness 25/100

NotionX/react-notion-x#487 · Opened May 23, 2023
Can't get Image Source On Amazonaws Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

NotionX/react-notion-x#485 · 2 reactions · Opened May 21, 2023
approuter support? Open

Difficulty 5/5 Over a week Newbie friendliness 15/100

NotionX/react-notion-x#484 · 1 comment · 3 reactions · Opened May 17, 2023
support darkmode automatically Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#483 · 2 reactions · Opened May 16, 2023
Can split previewImages and nextImage into two separate functions? Open

Difficulty 4/5 3-5 days Newbie friendliness 30/100

NotionX/react-notion-x#482 · Opened May 13, 2023
NotionRenderer not rendering components properly Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#479 · Opened May 4, 2023
React-Notion-X unusable without node.js Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#478 · 9 reactions · Opened May 1, 2023
Images from Signed URL returns 403 Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

NotionX/react-notion-x#476 · 7 comments · Opened Apr 25, 2023
The Minimal Example has Errors Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

NotionX/react-notion-x#475 · Opened Apr 24, 2023
Missing Getting Started Documentation with Critical Notion Information Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

NotionX/react-notion-x#474 · 4 comments · 1 reaction · Opened Apr 24, 2023
table style error? Open

Difficulty 3/5 1-2 days Newbie friendliness 25/100

NotionX/react-notion-x#468 · Opened Apr 15, 2023

NotionX/react-notion-x

Get new issues in your inbox