Link previews & Synced Databases

Synced Databases - hero
In this Article

Bring your favorite tools into Notion with link previews and Synced Databases, to keep all of your info in one easily accessible hub 📬


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

  • Dropbox

  • OneDrive & Sharepoint

  • Pitch

  • Amplitude

  • Hex

  • GRID

  • GitLab

  • Box

  • Lucid (Lucidspark and Lucidchart)

  • 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!

Note: Specific link and content types may not support previews. For example: Jira project URLs do not have an associated preview, but Jira issue URLS do.

  • 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.

Note: Once you've authenticated a connected app, anyone who can view your Notion page will be able to see corresponding content that you've pasted as a link preview.

In some cases, information will be abstracted (e.g., channel names from Slack private channels and DMs).

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!

Tip: You can paste links as mentions directly inline, next to other text!

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!

Authenticate your JIRA or GitHub account

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.

Create a synced database

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.

Note: Synced Databases update based on actions taken in JIRA and GitHub. At the moment, property types and values imported directly from those external platforms are view-only.

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.

People properties in synced databases

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 →.


Give Feedback

Was this resource helpful?


Powered by Fruition