Script Projects

A script project represents a collection of files and resources in Google Apps Script, sometimes referred to simply as "a script". A script project has one or more script files which can either be code files (having a .gs extension) or HTML files (a .html extension). You can also include JavaScript and CSS in HTML files.

The script editor always has one and only one project opened at any given time. You can open multiple projects in multiple browser windows or tabs.

Create and delete projects

This section explains how to create and delete standalone or container-bound Apps Script projects.

Create a standalone project

To create a standalone project from Apps Script:

  1. Go to script.google.com.
  2. Click New Project.
  3. In the script editor, click Untitled project.
  4. Give your project a name and click Rename.

Create a standalone project from Google Drive

  1. Open Google Drive.
  2. Click New > More > Google Apps Script.

Create a container-bound project from Google Docs, Sheets, or Slides

  1. Open a Docs document, a Sheets spreadsheet, or Slides presentation.
  2. Click Extensions > Google Apps Script.
  3. In the script editor, click Untitled project.
  4. Give your project a name and click Rename.

Create a container-bound project from Google Forms

  1. Open a form in Google Forms.
  2. Click More > Script editor.
  3. In the script editor, click Untitled project.
  4. Give your project a name and click Rename.

Create a standalone project using the clasp command line tool

clasp is a command line tool that allows you create, pull/push, and deploy Apps Script projects from a terminal.

See the Command Line Interface using clasp guide for more details.

Delete a container-bound project

  1. Open your container-bound project using the appropriate method above.
  2. At the top left, click Overview .
  3. At the top right, click Remove > Delete forever.

Delete a standalone project

  1. Go to script.google.com.
  2. At the right of the project you want to delete, click More > Remove > Remove.

Manage files in a project

Create a file

  1. Open your Apps Script project.
  2. At the left, click Editor > Add .
  3. Select the type of file to create and give it a name.

Delete a file

  1. Open your Apps Script project.
  2. At the left, click Editor .
  3. Next to the file you want to delete, click More > Delete.

Export files out of an Apps Script project

To take code files out of Apps Script, you can either copy and paste the code from each file into your preferred text editor or use clasp on the command line. To use clasp, refer to download a script project.

Set the time zone for a project

You can set the time zone for an Apps Script project. Functions performed by the script use this time zone.

  1. Open your Apps Script project.
  2. At the left, click Project Settings The icon for project settings.
  3. In the Time zone section, select the time zone you want to use.

If you want a specific function to use a different time zone than the script project’s, explicitly enter the time zone in your function. For example, in the below sample, each function creates a new event in Google Calendar. The first function defaults to the project time zone. The second function specifies the Pacific time zone, so the event is scheduled in Pacific time, regardless of the project’s time zone.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

Fix issues with multiple Google Accounts

If you're logged into multiple Google Accounts at the same time, you might have trouble accessing your add-ons and web apps. Multi-login, or being logged into multiple Google Accounts at once, isn't supported for Apps Script, add-ons, or web apps.

  • If you open the Apps Script editor while logged in to more than one account, Google prompts you to choose the account you want to proceed with.

  • If you open a web app or add-on and experience multi-login issues, try one of the following solutions:

    • Log out of all your Google Accounts and only log in to the one that has the add-on or web app you want to access.
    • Open an incognito window in Google Chrome, or an equivalent private browsing window, and log in to the Google Account that has the add-on or web app you want to access.