Skip to main content
Use the Google Sheets integration to get data from spreadsheets into Vistaly.

Setting up a direct sync

Following these steps will create a live sync between your Google Sheets and Vistaly.
  • Step 1: Format your Sheet
  • Step 2: Add the Google App Script
  • Step 3: Create/Enter your API Key
  • Step 4: Set the “On edit” Trigger

Step 1 (Format your Sheet)

Add the following column headers to your spreadsheet. You can rename these, but the order is important if you don’t want to modify the App Script code shared in the next step. Note: Both Column D and Column E automatically update once a change to the metric value has been saved in Vistaly.

Column A (Vistaly Card ID)

This is the identifier that will link this row of your spreadsheet to a Vistaly card. You can only link Vistaly Cards that support numeric values (KPIs, Outcomes, Key Results, etc…) To find a Card ID, open your Vistaly workspace, select the card you want to link and copy the last part of the URL (the cardId query parameter) ex: app.vistaly.com/w/IGOeM6Ymm1q8bcnYsuZcb?cardId=5tx6DnTlsCRCgnWGWXjZ1

Additional Columns

You can add any additional columns you need after these 5 required columns without issue.

Step 2 (Add the Google App Script)

The App Script will set up a live sync between your spreadsheet and Vistaly. Select Extensions > App Script and paste the App Script Code into the Editor.

Step 3 (Create/Enter your API Key)

To authenticate your Google Sheet with your Vistaly workspace, you first need to add your API Key. If you haven’t created an API Key yet, follow these steps to create one. Then add your API Key in the Google App Script Editor by selecting the Settings page and then scrolling down to Script Properties. Add the property as API_KEY and the value as your secret Vistaly API Key and select Save script properties.

Step 4 (Set the “On edit” Trigger)

The last thing you need to do is tell Google how you want the App Script to run. Go to the Triggers, page and update the for to reference your App Script. Note: If you haven’t set something like this up before, you will have to authorize Google to talk to external sources.

Testing it out

You’re all set. Whenever you make changes to a value in your spreadsheet, as long as the Vistaly Card ID is set in the corresponding row, it will automatically update Vistaly. As always, if you experience any issues getting set up, reach out to support@vistaly.com.