Notion 위젯이 로드되지 않나요?
먼저 원인을 찾으세요.
빈 블록, 로그인 요청, 작게 잘린 위젯은 모두 같은 문제처럼 보일 수 있지만 원인은 다릅니다. 대시보드를 다시 만들기 전에 이 점검 목록으로 원인을 확인하세요.
먼저 위젯의 정확한 URL 과 오류가 발생하는 기기 및 앱을 기록하고, 위젯이 별도의 브라우저 탭에서는 작동하는지 확인하세요. 이 가이드는 Notion의 임베드 동작을 외부 위젯의 호스팅, 계정, API, 브라우저, 저장소 요구 사항과 구분합니다. 특정 Saif Saber Studio 위젯에 오류가 발생했다는 보고가 아니라 문제를 조사하는 방법입니다.
3분 점검: 정확히 어떤 화면이 보이나요?
- 빈 프레임 또는 Failed to Load: 먼저 URL이 정확한지, 원본 사이트에서 임베드를 허용하는지 확인하세요. 캐시를 지우면 iframe 정책이 우회된다고 가정하지 마세요.
- 로그인 화면: 원본 서비스에 별도 로그인이 필요한지, 현재 Notion 앱에서 이를 지원하는지 확인하세요.
- 프레임은 보이지만 데이터가 없음: 위젯에 필요한 네트워크, API, 권한 또는 입력값을 확인하세요.
- 설정 화면이나 Start 버튼이 보임: 의도된 동작일 수 있으며 로딩 오류가 아닐 수도 있습니다. 예를 들어 현재 Flag Quiz는 Start quiz를 누르기 전에는 문제나 타이머를 시작하지 않습니다.
- 위젯 일부가 잘림: 블록의 너비와 높이를 늘리고 같은 URL로 다시 테스트하세요.
- 진행 기록이 초기화되거나 사라짐: 위젯이 상태를 Notion 페이지가 아니라 브라우저에 저장하는지 확인하세요.
Notion 웹, 데스크톱, 모바일에서의 결과를 각각 기록하세요. 일반 웹사이트의 iframe에서 성공했다고 해서 Notion 앱에서도 같은 위젯이 작동하는 것은 아닙니다.
1. 삽입한 정확한 URL 확인
- 위젯 자체의 상세 페이지나 사용자 설정 페이지를 열고, 제공된다면 해당 위젯 전용 임베드 또는 공유 URL을 복사하세요.
- URL이
https://로 시작하고 오타 없이 열리는지 확인하세요. Embed URL 필드에 원시<iframe>HTML 코드를 붙여 넣지 마세요. - Notion에서 Embed 블록을 만들려면
/embed명령이나 블록 추가 메뉴를 이용하고 URL을 붙여 넣으세요. 북마크나 링크를 대신 선택했다면 위젯 오류로 판단하기 전에 블록 유형을 확인하세요. - 새 브라우저 탭에서 직접 링크를 테스트하세요. 문제를 조사하는 동안 임베드 옆에 일반 원본 링크도 남겨 두세요.
Notion의 공식 임베드 설명서 에는 Embed 블록, URL 입력, 크기 조절, 일부 원본 사이트가 삽입을 막는 이유가 설명되어 있습니다. Notion의 메뉴 이름은 바뀔 수 있으므로 스크린샷을 게시하기 전에 현재 앱을 다시 확인하세요.
2. 위젯이 원래 웹사이트에서는 작동하나요?
원본 페이지 자체가 로드되지 않는다면 Notion 블록이 이를 안정적으로 해결할 수는 없습니다. 주소, 인터넷 연결, 원본 호스트 상태를 확인하고 브라우저 확장 프로그램이나 네트워크 필터가 필수 리소스를 차단하는지도 살펴보세요. 직접 열면 작동한다면 임베드 버전과 비교하세요 같은 기기와 네트워크에서 임베드 환경에서만 발생하는 문제인지 구분할 수 있습니다.
한 번에 변수 하나만 바꾸고 결과를 기록하세요. 상태가 브라우저에 로컬로 저장되는지 확인하기 전에는 데이터를 지우거나 대시보드를 삭제하지 마세요.
3. 원본 웹사이트에서 임베드를 허용하나요?
웹사이트가 독립된 탭에서는 정상적으로 열리지만 다른 사이트 안에서는 표시를 거부할 수 있습니다. 관련 임베드 정책은 원본 사이트 운영자가 관리하고, Notion도 자체 방식으로 임베드를 처리합니다. 프레임이 제한을 표시한다면 이를 우회하려 하지 말고 제공업체가 지원하는 링크나 공식 연동을 사용하세요.
Notion은 일부 사이트가 임베드를 금지하여 Failed to Load 오류가 나타날 수 있음을 명시합니다. 이는 문서화된 가능성일 뿐, 모든 빈 프레임에 대한 확정 진단은 아닙니다.
4. 별도 로그인이 필요한가요?
Notion의 임베드 도움말에 따르면 외부 웹사이트 로그인이 필요한 임베드는 데스크톱이나 모바일 Notion 앱에서 작동하지 않습니다. 이미 로그인된 브라우저에서 미리보기가 보인다고 해서 앱 호환성이 입증되는 것은 아닙니다.
외부 서비스에서 허용하는 공유 또는 공개 보기 기능이 있다면 사용하고, 없다면 일반 링크를 유지하세요. 임베드를 표시하려고 계정, 비공개 문서, API 토큰, 서비스 키를 공개해서는 안 됩니다. 원본 서비스의 권한을 존중하세요.
5. 프레임은 로드되지만 데이터나 컨트롤이 없음
위젯은 실시간 날씨, 환율, 소셜 플랫폼 API, 외부 미디어, 기기 위치 또는 다른 서비스에 의존할 수 있습니다. 프레임은 표시되지만 데이터가 없거나 오래되었다면 각 위젯의 입력값, 권한, 관련 서비스의 공식 상태를 확인하세요. 네트워크 접근, 요청 제한, 공급업체 변경, 브라우저 제약은 정적인 인터페이스와 다르게 작동할 수 있습니다.
제한 없는 API 키를 공개 임베드 URL에 넣지 마세요. URL 매개변수는 복사되거나 공유되거나 로그에 저장될 수 있습니다. 비밀 정보가 필요한 위젯이라면 문제 해결을 멈추고 실제 보안 모델부터 검토하세요.
비교 기준으로 로그인 없이 작동하고 외부 의존성이 적은 위젯을 문제가 있는 위젯과 비교하세요. 하나의 임베드가 성공했다는 사실은 블록이 작동할 수 있음을 보여 줄 뿐 모든 외부 서비스의 호환성을 보장하지 않습니다.
6. 위젯이 단순히 작거나 잘린 건가요?
- Notion의 Embed 블록에 마우스를 올리고 표시되는 측면 핸들을 이용해 너비를 늘리세요. 세로 공간과 주변 열도 확인하세요.
- 컨트롤이 사라졌다고 판단하기 전에 같은 원본을 전체 너비 열에서 테스트하세요.
- 좁은 모바일 화면에서도 테스트하고 마우스 없이 버튼을 누를 수 있는지 확인하세요.
- 대화형 콘텐츠에서는 Tab 및 Shift+Tab 키로 이동하고 iframe 밖으로 나오는 방법도 테스트하세요. 포커스가 갇히면 확인이 끝날 때까지 일반 링크를 사용하세요.
Notion은 임베드 크기 변경과 열 배치를 문서화합니다. 핸들 모양은 플랫폼마다 다를 수 있으며 터치 기기에서는 다른 컨트롤이 나타날 수 있습니다. 프레임을 키워도 원본 사이트의 차단이나 누락된 네트워크 데이터는 해결되지 않습니다.
7. 위젯의 설정이나 진행 기록이 사라졌나요?
모든 위젯이 Notion 데이터베이스에 정보를 저장하는 것은 아닙니다. 일부는 브라우저 로컬 저장소나 세션 상태를 사용하는데, iframe 안에서 분리되거나 개인정보 보호 설정으로 지워지거나 브라우저와 기기마다 다를 수 있습니다. Notion에서 위젯이 보인다는 사실만으로 내부 상태가 작업 공간과 동기화되는 것은 아닙니다.
브라우저를 초기화하거나 저장소를 삭제하거나 페이지를 복제하기 전에 위젯이 실제로 제공하는 저장 및 내보내기 기능을 살펴보세요. 예를 들어 Focus Scoreboard는 자연스럽게 완료된 집중 단계만 저장되는 Pomodoro Timer의 브라우저 로컬 로그를 읽고, 기록 초기화 시 관련 공유 타이머 기록도 삭제됩니다. 먼저 Full History JSON 백업을 내보내세요. 두 임베드의 결과가 다르다면 위젯 호스트에서 같은 저장소 컨텍스트에 접근할 수 있는지 확인하세요. Notion은 이러한 기록을 동기화하지 않습니다. 테스트하지 않고 기기 간 동기화를 약속하지 마세요.
안전한 다음 단계 선택
- URL이 잘못됨: Embed 블록을 제공업체의 올바른 URL로 바꾸세요.
- 원본 서비스를 사용할 수 없음: 원본 서비스를 조사하거나 공식 복구를 기다리세요. 일반 링크는 유지하세요.
- 임베드가 차단됨: iframe 제한을 우회하는 대신 링크, 북마크 또는 공식 지원 연동을 사용하세요.
- 외부 로그인 필요: 특히 Notion 데스크톱과 모바일 앱에서는 허용된 공개 보기나 직접 링크를 사용하세요.
- 프레임이 작거나 잘림: 크기나 열을 조절한 뒤 다시 테스트하세요.
- 저장된 상태가 없음: 무언가를 지우기 전에 로컬 저장소와 내보내기 동작을 확인하세요.
문제가 계속되면 비밀 정보 없는 위젯 URL, Notion 플랫폼, 브라우저나 앱 버전, 직접 탭에서의 동작, 표시된 오류, 이미 시도한 방법을 기록하세요. 로그인 정보를 노출하지 않고도 재현 가능한 오류 보고서를 만들 수 있습니다.
자주 묻는 질문
Chrome에서는 위젯이 되는데 Notion 데스크톱 앱에서는 왜 안 되나요?
임베드 환경이 다를 수 있습니다. 외부 로그인 제한, 브라우저 저장소, 권한 처리가 원인일 수 있습니다. 한 가지 해결책을 가정하지 말고 같은 위젯, URL, 로그인 상태를 각 플랫폼에서 비교하세요.
iframe HTML 코드를 Notion에 직접 붙여 넣어도 되나요?
Notion의 Embed 블록에는 원본 URL이나 임베드 링크가 필요하며 원시 iframe HTML 태그는 사용할 수 없습니다. 제공업체가 안내한 HTTPS 링크와 블록의 Embed 옵션을 사용하세요.
Notion 페이지를 공개하면 위젯 문제가 해결되나요?
반드시 그렇지는 않습니다. 페이지 공개 여부로 원본 웹사이트의 임베드 정책, 외부 서비스 권한, 위젯의 API 및 저장소 요구 사항을 우회할 수 없습니다.
삽입된 타이머나 추적기가 Notion 데이터베이스와 동기화되나요?
위젯을 삽입하는 것만으로 Notion 데이터베이스 연동이 만들어지는 것은 아닙니다. 중요한 기록을 맡기기 전에 실제 지원되는 저장 및 연동 기능을 확인하세요.