• Documentation

What data is sent and received when pasting a Smart Link?

This is an outline of what happens when you paste a URL and it turns into a Smart Link. It’s a technical explanation, written for anyone who’s concerned about the security implications of Smart Links.

We’ve used a Google Drive link in this example, but this information is true for other products too.

When you paste a link to a Google Drive document on Confluence or Jira, our system can turn it into a Smart Link. This means you’ll see more information about the file, like its title, last updated date, and a preview image.

Learn more about Smart Links

When you paste a link, our system will check if it's a valid Smart Link based on a domain pattern match (in this example, it’ll check for Google.com).

If the domain matches, and if you’re logged in to your Google account, we’ll transform your link into a Smart Link.

What happens if you’re not logged in?

The system will ask you to connect and log in to your Google account; this is done using the OAuth2 protocol. This process allows you to log in to your Google account, get an authentication token, and store it securely within our system. This token is crucial for retrieving data from Google (more on that in the next section).

Use the same connected account across Atlassian features and products

After connecting your Google account, you don’t have to repeat the process of logging in and getting an authentication token. You may be asked to allow certain permissions when you need to use the same account in other products and features.

For information on what information we receive after you connect, read our Privacy Policy.

Once you’ve pasted a link and logged in, our system uses your authentication token (see previous section) to access Google’s API and receive data about the file like the title, preview image, and last updated date. These details are displayed in the Smart Link.

Our system retrieves the data in real-time using your authentication token. This means you’ll only see details about the Google Drive file if you have permission to do so.

For Rovo customers, we save data like filenames and URLs from Figma links securely in our servers and make it available to serve Rovo features like Search.

Read more on how Rovo shows Figma results

If the domain of the link you paste is unrecognized and not supported by Smart Links, our system skips the authentication process and calls a third-party service called iFramely.

iFramely will take your link, search the web for metadata that's publicly available, and display it in the Smart Link. If the link requires authentication, we won’t be able to retrieve any information and will simply display the link as pasted.

Either way, we don’t submit any user data or client information to any third-party services.

Learn which products are supported by Smart Links

Update the IP ranges of your allow-list

As an Atlassian Cloud feature, Smart Links may not work if you don’t update your network restrictions to include the IP ranges in your allow-list.

Read more on IP address ranges for Atlassian Cloud products and sites

Still need help?

The Atlassian Community is here for you.