Connecting Notion

Connecting your Notion workspace to Notionarise is the first step to creating interactive widgets. This guide will walk you through the authorization process and explain what permissions are needed.

Authorization Process

Notionarise uses Notion's official OAuth 2.0 integration to securely connect to your workspace. This ensures your data remains private and secure.

Step-by-Step Guide

1. Navigate to Dashboard - After signing up, you'll be prompted to connect your Notion account
2. Click "Connect Notion" - This will redirect you to Notion's authorization page
3. Select Workspace - Choose which Notion workspace you want to connect
4. Grant Permissions - Review and approve the requested permissions
5. Complete Setup - You'll be redirected back to Notionarise

Required Permissions

Notionarise requests the following permissions from your Notion workspace:

Read Access

• Read database content - To fetch data from your databases for widget calculations
• Read page content - To access database entries and their properties
• Read user information - To identify you and your workspace

Why These Permissions?

Notionarise needs read access to:

• Fetch habit completion data for heatmap widgets
• Calculate progress percentages for progress bar widgets
• Track task completion for level systems
• Display real-time statistics in your widgets

Note: Notionarise only requests read-only access. We cannot modify, delete, or create any content in your Notion workspace.

Security & Privacy

Your security and privacy are our top priorities:

• OAuth 2.0 - Industry-standard secure authorization
• Read-Only Access - We can only read data, never modify it
• Encrypted Storage - All tokens and credentials are encrypted at rest
• No Data Sharing - Your Notion data is never shared with third parties
• GDPR Compliant - We follow strict data protection regulations

Selecting Pages and Databases

After connecting your Notion account, you'll need to grant Notionarise access to specific pages and databases:

Integration Permissions

1. Open Notion - Go to the page or database you want to use
2. Click the ••• Menu - In the top-right corner of the page
3. Select "Connections" - Previously called "Add connections"
4. Choose "Notionarise" - Grant access to the Notionarise integration

Bulk Access

If you want to give Notionarise access to multiple pages:

1. Share from a parent page to grant access to all child pages
2. Or individually share each database you want to use
3. You can revoke access at any time from the same menu

Troubleshooting

Connection Failed

If the authorization fails:

• Ensure you have admin rights in your Notion workspace
• Check that you're logged into the correct Notion account
• Try clearing your browser cache and cookies
• Disable browser extensions that might interfere with OAuth

Integration Not Appearing

If Notionarise doesn't show up in your connections:

• Make sure you completed the OAuth flow successfully
• Verify your connection in the Notionarise dashboard
• Try disconnecting and reconnecting your account

Access Denied Errors

If widgets show "Access Denied":

• Ensure you've shared the specific database with Notionarise
• Check that the database wasn't deleted or moved
• Verify the integration hasn't been removed from the page

Managing Connections

Viewing Connected Workspaces

In your Notionarise dashboard:

1. Navigate to Settings → Integrations
2. View all connected Notion workspaces
3. See which databases are currently accessible

Reconnecting

If your connection expires or is revoked:

1. Go to Settings → Integrations
2. Click Reconnect next to your workspace
3. Complete the OAuth flow again

Disconnecting

To disconnect your Notion workspace:

1. Go to Settings → Integrations
2. Click Disconnect next to your workspace
3. Confirm the disconnection
4. Note: This will break all widgets using that workspace

Multiple Workspaces

Notionarise supports connecting multiple Notion workspaces:

• Each workspace is managed independently
• Widgets are tied to specific workspaces
• Switch between workspaces in the dashboard
• Premium plans support unlimited workspaces

Next Steps

Now that your Notion workspace is connected, you're ready to:

• Connect your databases to start creating widgets
• Explore different widget types and their capabilities
• Learn how to map database fields to widget requirements

If you encounter any issues during the connection process, please contact our support team for assistance.