Workbranch › Guides

Guide

How to add knowledge files to a custom GPT

Knowledge files give a custom GPT its own reference material, but the limits are strict and the GPT doesn't always use them the way you expect. Here's how to upload, update and test them, and what happens to them when custom GPTs retire.

Updated 6 November 2026

Quick answer: on chatgpt.com, open Explore GPTs, go to My GPTs, pick your GPT and select Edit GPT. Upload your files in the Knowledge section, test the GPT in Preview, then select Update. A GPT holds up to 20 knowledge files of up to 512 MB each, and when you migrate it to a plugin the files are copied over as reference files.

These steps were checked against OpenAI's help pages on 6 November 2026. OpenAI plans to retire custom GPTs on 11 December 2026, so this guide also covers what happens to your files then.

Before you start: who can still edit a GPT

As of November 2026, personal accounts (Free, Go, Plus and Pro) can't create new GPTs, but you can keep editing GPTs you made earlier if your plan and permissions still allow it. In Business, Enterprise and Edu workspaces, editing depends on your workspace settings and role. Two more rules matter:

If you still need to build the GPT itself, start with our guide on how to create a custom GPT.

Step by step: add knowledge files

  1. On chatgpt.com, open Explore GPTs in the sidebar, or go to chatgpt.com/gpts.
  2. Select My GPTs and choose the GPT. Then select Edit GPT. If you're already chatting with it, you can open the GPT's menu and pick Edit GPT there.
  3. Switch to the configuration view so you can edit each field directly, and scroll to Knowledge.
  4. Upload your files in the Knowledge section.
  5. If a file type is refused, check Capabilities: some types only work when Code Interpreter & Data Analysis is turned on.
  6. Add a line to the Instructions telling the GPT when to use the files, for example: "Answer pricing questions from the price list in your knowledge, and name the section you used."
  7. Test in Preview with questions whose answers you know are in the files.
  8. Select Update to publish the change. Edits save to a draft as you go, but people using the GPT only get them after you update.

Limits and file types

LimitValue
Files per GPTUp to 20
Size per document or presentationUp to 512 MB
Text and document filesUp to 2 million tokens per file
Spreadsheets and CSVAbout 50 MB, depending on row size
ImagesUp to 20 MB each
Upload rateUp to 80 files every 3 hours (may be lower at peak times)
Total storage25 GB per user, 100 GB per organization

GPTs accept most common document, spreadsheet, image, text and code files. Which types work can depend on the model, which is why a file that uploads fine in one GPT may be refused in another.

How the GPT uses its files

Knowledge is reference material. The GPT draws on it while answering, but the files don't change how it behaves: tone, rules and steps belong in the instructions. OpenAI's advice for getting good results:

Keeping files up to date

A knowledge file doesn't sync with its original. When your source document changes, the GPT keeps answering from the old copy until you replace it:

  1. Open the GPT with Edit GPT and go to Knowledge.
  2. Remove the outdated file. OpenAI notes that a file added to a GPT's knowledge has to be removed in the GPT builder.
  3. Upload the new version, ideally with a date in the file name so you can tell versions apart.
  4. Retest in Preview and select Update.

If an update makes things worse, open the ••• menu in the editor and use version history to restore an earlier version.

Good to know

If it doesn't work

Sources

Frequently asked questions

What's the difference between knowledge and attaching a file in the chat?

Knowledge is part of the GPT's setup, so it's there as reference in every conversation with it. A file you attach in a chat with the GPT only applies to that chat, and it's the better route when you need ChatGPT to look at images or charts inside a PDF.

Do knowledge files count toward my storage?

OpenAI says the usual file-size rules and the per-user and per-organization storage caps apply to GPT knowledge as well, so big knowledge files eat into the same allowance as your other uploads.

Can I add files from my phone?

No. Creating and editing GPTs only works on ChatGPT on the web; the mobile apps let you chat with GPTs but not change them.