Skip to content
eWiki The practical AI reference

Tutorials

How to Create a Reusable Gem in Gemini With Custom Instructions and Reference Files

Original editorial hero image for How to Create a Reusable Gem in Gemini With Custom Instructions and Reference Files

A Gem in Gemini saves custom instructions and optional reference files for a recurring task. Create one in the Gemini web app, test it in the preview area, and explicitly save it for reuse.

What You Need Before Creating a Gem

Creating or using Gems requires you to sign in to Gemini Apps. For personal accounts, Google says users must be at least 13 or meet the applicable minimum age in their country. Work and school accounts may have different terms or administrative requirements.

On a computer, sign in at gemini.google.com and look for Gems in the sidebar. If you are creating one for the first time and cannot find that entry, Google’s instructions say you may need to open Settings and help, select Gems, and then choose New Gem.

Be aware that the interface may change soon. Google’s computer help, observed on October 18, 2026, says Gems on personal Google accounts will begin transitioning automatically to skills in November 2026. The names or locations of controls may therefore differ when you follow these steps.

Editorial detail illustrating evidence and decision criteria for How to Create a Reusable Gem in Gemini With Custom Instructions and Reference Files

Create the Gem and Write Reusable Instructions

In the Gemini web app, open Gems, select New Gem, and enter a name that identifies the recurring task. Then write the instructions Gemini should follow whenever you use that Gem.

Google recommends considering four elements when drafting the instructions:

  1. Persona: Define the role or perspective Gemini should adopt.
  2. Task: State what you want it to do.
  3. Context: Supply the background needed to understand the request.
  4. Response format: Describe how the answer should be organized.

You can use any relevant combination of these elements. A narrowly defined task and an explicit output format make the saved configuration easier to apply consistently. For example, the instructions can identify the intended task, provide its necessary context, and specify the structure expected in every response.

If you start with a short draft, Gemini can rewrite and expand it. Review the generated instructions and edit them before saving so the final wording still matches the task you intend the Gem to perform.

Editorial scene showing practical next steps for How to Create a Reusable Gem in Gemini With Custom Instructions and Reference Files

Add Reference Files, Preview, and Save

Use the Knowledge section when the Gem needs persistent reference material. Files can be uploaded from your device or added from Google Drive. Adding Drive files has two documented prerequisites: Keep Activity must be enabled, and Google Workspace must be connected to Gemini Apps. If the Drive option is unavailable, check those requirements before changing the Gem’s instructions.

Next, use the builder’s preview area to try the configuration. Review whether the response follows the requested persona, task, context, and format, then revise the instructions or selected files if necessary. Previewing is a test of the current setup; it does not save the Gem.

When the setup is ready, click Save. This final action is required even if the preview already produced a suitable response. Leaving the builder after previewing without clicking Save can mean the configuration is not preserved.

Conclusion

A reusable Gem combines a name, persistent instructions, and any optional Knowledge files, followed by an explicit save action. A Gem created in the Gemini web app also appears in the Gemini mobile app and the Gemini side panel in Google Workspace. It cannot currently be used with Gemini Live.

Personal-account users should also expect the announced transition from Gems to skills beginning in November 2026. To get started, open Gemini on a computer, define one recurring task with persona, task, context, and response-format instructions, add only the relevant reference files, test the preview, and click Save.

Disclosures and limitations

  • This article was prepared with AI assistance from the supplied research package and content plan. Factual claims are based only on the cited Google documentation summarized in those materials.
  • No product recommendations, prices, ratings, user reviews, or affiliate offers are included. The supplied research package contained no structured product records.
  • Google’s help information was observed on October 18, 2026. Because Google announced that personal-account Gems would begin transitioning to skills in November 2026, interface terminology and navigation may change.

Sources

Improve this guide

Report a problem or suggest the next question

Submissions enter a private editorial queue. They are reviewed and deduplicated before any public update or new page is created.