User Guide Getting Started Help Center Documentation Community Training
Scheduling SFTP Deliveries

Looker lets you schedule periodic delivery of a user-defined dashboard, a Look’s visualization, or a Look’s data to an SFTP server. Sending results to an SFTP server is a good method when your data or visualization is too large to send via email. If you choose this delivery option, Looker prompts you for the SFTP server address, username, and password as described below. Check out this Community topic for more details about delivering data using SFTP.

To receive SFTP deliveries from Looker, be sure your network admin has added Looker’s IP addresses to your SFTP server’s IP whitelist or inbound traffic rules.

Depending on how your Looker admin has configured your permissions, the default delivery destination may be email, and this setting may not be visible.

Creating and Editing Schedules

After starting a schedule, Looker displays a dialog box with your scheduling choices. The screen below shows an example Schedule dialog box for a dashboard:

The following sections explain each scheduling setting for SFTP server destinations. For a description of all scheduling options, see the main scheduling documentation page.

Naming Your Delivery

Give the content a unique title in the Give your schedule a name field. The title is included in the file name of the data delivery.

Delivering to SFTP

In Destination, choose SFTP. If your destination is an SFTP server, Looker prompts you for the URL and login information for the server:

Currently, SFTP support is limited to username and password credentials. SSH private key credentials are not supported. Check out this Community topic for more details about delivering data using SFTP.

To learn more about other types of data delivery, see the page for each destination option: email, Amazon S3 bucket, applications using a webhook, or one of several integrated services.

Formatting the Data

In Format data as, choose the format for the data in your delivery.

For dashboards, you can choose:

For Looks, you can choose:

Using Advanced Options for SFTP Servers

The Advanced options section provides additional customization for your schedule. Click the arrow next to Advanced options to expand this menu.

Scheduling Conditions

For all Look formats other than JSON—Detailed, Inline, you can add conditions for when the data will be delivered:

Scheduling Limits

When scheduling Looks, you can limit the size of your delivery. Select one of the following limit options for your data:

If you choose Results in Table, Looker will obey whatever row limitations you've set up in the saved Look. If you choose All Results, Looker will return all the rows of the query, regardless of the saved Look settings, and regardless of Looker's typical 5,000 row limit. This can be desirable for retrieving very large datasets, but you should use caution to ensure the query is not too large for your database.

Format Options

Apply Visualization Options

For Looks, Explores, and CSV-formatted dashboards, you can configure whether you want the data delivery to use the same options as your visualization:

Formatted Data Values

For Looks and the CSV format of dashboards, you can configure the data's formatting:

Single Column Layout

For dashboard deliveries in PDF or Visualization format, you have the option to print your PDF in a single column layout, which displays dashboard tiles in a single vertical column. Check the Use single column layout box to use this option, or leave the box unchecked to show the tiles as they are arranged in the dashboard.

Expand Tables

To display all rows of a data table — rather than just those rows that display in the dashboard tile thumbnail — in a PDF dashboard delivery or download, check the Expand tables box. If you do not see the Expands tables option, talk to your Looker admin about installing the Chromium renderer for your Looker instance.


By default, Looker will use the time zone associated with your account to determine when to send your data delivery. If you don't have a time zone associated with your account, Looker will use your Application time zone. If you want to specify a different time zone, select Use custom timezone. The time zone you select does not affect the data in your Look or dashboard, just the timing of the delivery.

Paper Size

You have the option to specify the optimal size and orientation of dashboard PDFs by selecting from the Paper size drop-down menu. Large visualizations or groups of overlapping dashboard tiles may need to be resized to fit cleanly on a PDF page. If you do not see the Paper size option, talk to your Looker admin about installing the Chromium renderer for your Looker instance.