Link previews & Synced Databases

Link previews allow you to see live, synced visualizations of links directly in Notion. This is currently supported for several platforms:

• GitHub

• Jira

• Slack

• Asana

• Trello

• Linear

• Zoom

• Figma

• Adobe XD

• Dropbox

• OneDrive & Sharepoint

• Pitch

• Amplitude

• Hex

• GRID

• GitLab

• Box

• Lucid (Lucidspark and Lucidchart)

• Whimsical

• ClickUp

• Copy a link from any of the supported platforms. Paste it into Notion and you'll see the option to Paste as preview. Select this!

• The first time that you paste a link from one of these platforms, you'll see a button that asks you to connect to the app.

• Once you click the button to connect, you'll be redirected to a browser window. Here, the app will ask for authentication and permission to display content in Notion.

• When you've authenticated with the app, you'll see a detailed preview of the linked content. This preview updates as changes are made to any relevant fields.

In addition to previews, you can also paste links from these platforms as mentions. These provide a more condensed visualization of the content in the link.

• Copy a link from any of the supported platforms. Paste it into Notion and you'll see the option to Paste as mention.

• Similarly to previews, you'll have to authenticate the app the very first time you paste a corresponding link in Notion. Click the button to open the authentication window and grant the necessary permissions. Afterward, you'll see the link mention pop up!

Synced databases allow you to sync data from other platforms as Notion databases. Platforms include:

• Jira boards and projects

• GitHub PRs and issues

• Asana projects and tasks

• GitLab merge requests and issues

More apps will be supported in the future!

To set up a synced database, you must first authenticate JIRA and GitHub in Notion.

• Go to your left sidebar and click Settings & members.

• Choose My connections.

• Find JIRA or GitHub in the menu and click Connect.

• You’ll be prompted to authenticate by logging in to your account.

You can now sync JIRA and GitHub content into Notion as synced databases.

• In JIRA, copy the link to a project or board. In GitHub, copy the link to a PR or issue.

• Paste the link into Notion and select Paste as database.

• An empty database with a preset list of properties will show up in your page. It will show up in a Notion table view, with all JIRA/GitHub properties automatically added.

• The database will begin populating automatically and will continue to sync if you navigate away from the page.

You can add any Notion property to a synced database. There are two things to know when adding an additional Notion property onto a synced databaseL

• If a property is deleted on the third-party app (i.e. you delete a task in Jira), the associated synced database row and all properties will be deleted. They will be accessible in the trash to view what was deleted, but cannot be restored.

• If an added Notion property shares a name with any third-party properties (Jira, GitHub, GitLab, or Asana), that property will not sync.

Synced databases will include people properties! Now, you can use identity mapping to connect third party GitHub and JIRA identities to your team's Notion profiles.

For GitHub:

• Navigate to your GitHub email settings and ensure that the box for "Keep my email addresses" private is not checked on.

• Then in your GitHub profile: https://github.com/{YOUR_USERNAME_HERE}, edit your profile to add your Notion email address.

• This enables your identity to be mapped for synced databases, only for workspaces you are a member of.

For JIRA:

• Confirm you have implemented Jira Cloud.

• If you’re an admin, click on Jira System settings and change the user email visibility from “Hidden” to “Public” inside your organization. 

• If you're an individual user, need to manually change their settings by going to the Profile and visibility page and changing the email visibility option. You can follow the instructions here →.