Workbranch › Guides
GuideHow 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.
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:
- Web only. The GPT builder isn't available in the mobile apps.
- Migrated GPTs are frozen. Once a GPT has been moved to a plugin, the original becomes read-only, so you change the files in the plugin instead.
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
- On chatgpt.com, open Explore GPTs in the sidebar, or go to chatgpt.com/gpts.
- 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.
- Switch to the configuration view so you can edit each field directly, and scroll to Knowledge.
- Upload your files in the Knowledge section.
- If a file type is refused, check Capabilities: some types only work when Code Interpreter & Data Analysis is turned on.
- 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."
- Test in Preview with questions whose answers you know are in the files.
- 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
| Limit | Value |
|---|---|
| Files per GPT | Up to 20 |
| Size per document or presentation | Up to 512 MB |
| Text and document files | Up to 2 million tokens per file |
| Spreadsheets and CSV | About 50 MB, depending on row size |
| Images | Up to 20 MB each |
| Upload rate | Up to 80 files every 3 hours (may be lower at peak times) |
| Total storage | 25 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:
- Favor plain, text-heavy files. The GPT struggles more with elaborate layouts, so a clean document with headings beats a heavily designed brochure.
- Watch out for pictures in PDFs. OpenAI treats knowledge files differently from attachments you add in a chat, and pictures embedded in them may be skipped. If a chart matters, describe it in text in the file, or attach the PDF or image directly in the chat when you need it.
- Ask for citations in the instructions. If you want quotes or references to the files, say so and describe the format.
- Test after every change. Preview is the only way to see whether the GPT actually finds the new content.
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:
- Open the GPT with Edit GPT and go to Knowledge.
- Remove the outdated file. OpenAI notes that a file added to a GPT's knowledge has to be removed in the GPT builder.
- Upload the new version, ideally with a date in the file name so you can tell versions apart.
- 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
- Retirement: custom GPTs are scheduled to retire on 11 December 2026 (11 February 2027 for FedRAMP workspaces and approved deferrals). After that date GPT pages become inaccessible, though your past conversations stay.
- Migration keeps your files. With Migrate to plugin in My GPTs, the knowledge files are copied into the plugin's reference files and the instructions become a skill. Only the latest published version moves, so select Update on any file changes first.
- Privacy: GPT builders can't see people's individual conversations with their GPTs. On Business, Enterprise and Edu, data isn't used for training by default; on personal plans it depends on your data controls.
If it doesn't work
- No Edit GPT option. Your plan no longer allows editing, the GPT was already migrated, you're on the mobile app, or you didn't create it. Use the account or workspace where the GPT was made.
- "Upload limit reached" after only a few uploads. Check you're signed in to the right account, wait for the retry time shown in the error (failed attempts can count too), and check Settings → Storage.
- The GPT ignores the file. Make sure the answer is really in the text (not only in an image), simplify the layout, and point to the file in the instructions.
- The 20-file cap is too tight. Merge related documents into one well-structured file. For material that keeps growing, a ChatGPT project may suit you better; see custom GPT vs Projects.
Sources
- Creating and editing GPTs (OpenAI Help Center, checked 6 November 2026)
- Uploading files and audio to ChatGPT (OpenAI Help Center, checked 6 November 2026)
- GPTs in ChatGPT (OpenAI Help Center, checked 6 November 2026)
- Custom GPT retirement and migration FAQ (OpenAI Help Center, checked 6 November 2026)
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.