Use Gems in Gemini Apps

You can create and save Gems to customize responses in Gemini Apps to your specific needs.

What you need

Gemini Advanced:

To use Gems with a personal Google Account, learn how to upgrade to Gemini Advanced.
To use Gems with a work or school Google Account, your Google Workspace administrator must enable access to Gemini Advanced. Learn more about using Gemini Apps with a work or school account.

Important: When you create or chat with a Gem, remember that you agreed to Google's Terms of Service, including the Prohibited Use Policy. Be sure not to violate others' rights. Use your discretion before you rely on, publish, or use content that Gemini Apps generate. Users with a work or school account that has a Gemini Business, Gemini Enterprise, or Gemini Education add-on are subject to different terms. Learn more about how to use Gemini Apps on your work or school Google Account.

Learn how to get started with Gems

Use the Gems guide to get ideas for how to use Gems, learn how to get a quick start with premade Gems, and find suggestions for writing great Gem instructions.

Get started

Create, use & manage Gems

Important:

For now, you can’t generate images when using a Gem.
For now, Gems can’t be used with Gemini Live.
The Learning coach premade Gem doesn’t currently support language learning.

Create a Gem

On your computer, go to gemini.google.com.
At the bottom left, click Gem manager .
Click New Gem.
Enter a name for your Gem.
Optional: Enter instructions for your Gem.
- Tip: Adding instructions is highly recommended.
Click Save.

Other optional steps to improve your Gem

Use Gemini to re-write your instructions

After a few words, you can click Use Gemini to re-write instructions

to have Gemini Apps create more comprehensive instructions for most topics. It may take a few seconds for the generated instructions to appear.

Upload files to give your Gem more context

Important: For now, this feature is only available in Arabic, Chinese (simplified), English, Hebrew, Hindi, Portuguese (Brazilian), and Thai.

You can add files to give your Gem more context or to reference specific docs in your chats with the Gem. Learn more about supported file types and limits.

After you add instructions, you can upload files. Under Knowledge, click Add files .

To upload a file from your device: click Upload files.
To add a file from your Google Drive: click Drive .
- To add files from your Drive, you need to have Gemini Apps Activity on and connect Google Workspace to Gemini Apps. If it’s not connected, you'll get the option to connect it. Learn about your data and the Google Workspace extension.
- If you add a file from your Drive, Gemini will use the most recent version of the file. If you make changes to the file, these changes will be reflected in your Gem.

Tip:

You may need to scroll down to find the Knowledge section.
You can edit a Gem to remove a file or add more files later. Learn how to edit your Gem.

Preview your Gem

In the text box on the right, enter a prompt to preview the Gem and make edits to the instructions as needed.
Click Update.

Use a Gem in a chat

Go to gemini.google.com.
On the left under Gems, click on the Gem you want to use.
In the text box at the bottom, enter your question or prompt.
Click Submit .

Pin and unpin Gems

In the Gemini Apps menu, the Gems you have used or created most recently will appear at the top of your Gems. You can pin Gems to move them to the top.

Go to gemini.google.com.
On the left under Gems, find the Gem you want to pin or unpin.
Next to the Gem, click More .
- To pin the Gem, click Pin .
- To unpin the Gem, click Unpin .

Edit a Gem

Go to gemini.google.com.
On the left under Gems, find the Gem that you want to edit.
Click More Edit .
Make edits.
Click Update.

Delete a Gem

Go to gemini.google.com.
On the left under Gems, find the Gem that you want to delete.
Click More Delete .

Try experimental Gems

Experimental Gems allow you to try out early-stage Gemini features through Gems and share feedback. Experimental Gems are in development, and their quality and availability may vary. You can leave feedback to help us improve the overall experience.

Who can use experimental Gems

Currently, experimental Gems availability is limited to:

The Gemini web app
English
Users with Gemini Advanced. Learn how to upgrade to Gemini Advanced.

Where to find experimental Gems and how to use them

You can find experimental Gems in the Gems manager under Experiment.

Certain experimental Gems features work best when your Gemini Apps Activity is turned on. Some experimental Gems are not available if your Gemini Apps Activity is turned off.

How to tell if the Gem you’re using is experimental

Next to the Gem name, experimental Gems have an Experiment label.

Why Gemini Apps might remove a Gem

Gemini Apps may remove Gems when our systems detect a possible violation of Google's Terms of Service, including the Prohibited Use Policy.

Users with a work or school account that has a Gemini Business, Gemini Enterprise, or Gemini Education add-on are subject to different terms. Learn more about how to use Gemini on your work or school Google Account.