GPTLIST Function Reference



Given a prompt/question/request, returns a list of responses from OpenAI GPT language model.

=GPTLIST("Name five fruits that are yellow")

GPTLIST is a simple way to make a single request of one of OpenAI's GPT models and get a response in the form of multiple items, which will populate multiple cells at a time. List prompts are best constructed as very clear requests for a list of items and the ideal output:

=GPTLIST("Name the top 10 US cities by population. Include the name and population for each city in the form 'name: population'" & A1)


=GPTLIST(prompt, gpt_model, temperature, max_tokens, cache)

The function parameters are as follows:

Caution: The GPT4 model uses 25 times more SheetGPT usage credits than the default GPT3.5 model for only marginally better results in a few narrow use-cases. It is also much slower.







String (or cell reference) representing a user prompt




String representing the OpenAI GPT model to use. See the list of available models for usage and pricing details.




Number between 0 and 1 representing how much variance to introduce when responding. 0 is very little variance and 1 is the most variance.




Number representing the max number of tokens to return as the response.




Whether or not to cache the response. Setting to false will incur a re-execution on every cell refresh.

Advanced Options

The GPTLIST function accepts several optional arguments which you can use to further control the response to your prompt. Here are some examples:

Specify a different GPT model

The second argument to GPTLIST lets you specify a different OpenAI model to use when responding to your prompt. The default is currently "gpt-3.5-turbo" which is the best blend of cost-efficiency and performance. If you have more specific needs you may use one of the other OpenAI models instead:

=GPTLIST("Create a list of three types of animals", "gpt-4")

Using non-default models (such as GPT4) may consume your SheetGPT usage credits at a much higher rate than the default model. Please make sure you understand what you are doing before using a different model.

Adjust the variety of the response

The third argument to GPTLIST lets you specify a different "temperature" to use for the response. The temperature is a number between 0 and 1 (so a decimal like 0.5) that defines how much variability you want in your response.

=GPTLIST("Write three titles for an article reviewing the current state of natural language processing AIs", , 0.1)

A higher temperature like 1 (the default) means you are likely to get very different responses to the same prompt - there is more "drift" in the responses. Use a lower number like 0 or 0.1 if you want more determinism in your responses.

Limit the length of the response

The fourth argument to GPTLIST lets you specify a response length limit (in terms of tokens, which roughly equals half an average word in length). So if you want to limit the length of your response to about 15 words you could pass in 25 as the fourth argument to GPTLIST:

=GPTLIST("Count to ten",,, 25)

Performance & caching

The completion that is returned is cached by SheetGPT to ensure that cell refreshes and other Sheet actions do not cause an unnecessary burn on your tokens. 

Any GPTLIST request with the same arguments in a Sheet will return the cached value, indefinitely. This is well beyond the typical 6-hour cache limit of most Sheet plugins and is our attempt to make SheetGPT the most cost-effective way to utilize various GPT functionality.

If you ever need to avoid hitting the cache and force the generation of a new response, you can set the cache argument to false to force re-generation:

=GPTLIST("Name the five best Indonesian cities to visit in March?",,,,false)