How-to · ChatGPT for Mac

How to create a project in ChatGPT on Mac: steps, icons, and the missing Projects fix

To create a project in ChatGPT on Mac, open the desktop app, select New project in the sidebar, enter a name, then pick an icon and color. If Projects is missing, choose ChatGPT > Check for Updates first, because the July 2026 rebuild hid them in some builds.

Updated Checked against ChatGPT desktop app for macOS, 2026 builds with Projects in the sidebar10 minEasy

Person at a MacBook learning how to create a project in ChatGPT on Mac
A project keeps related chats and files in one place. · Image by StockSnap from Pixabay

Quick answer

  • Open the ChatGPT desktop app on your Mac, select New project in the sidebar, enter a name, then choose an icon and color.
  • If Projects is missing, update the app first with ChatGPT > Check for Updates, then reopen it.
  • Project instructions apply across the project's chats. Add files to Sources, or add a folder through Edit project > Add folder.
  • File caps apply per project: 5 on Free, 25 on Go and Plus, and 40 on Pro and above, according to a third party summary.

What you need

  • A Mac with the ChatGPT desktop app installed
  • The latest app build, from July 16, 2026 or later, so Projects are not hidden
  • The same ChatGPT account you use on the web
  • Files ready to upload, counted against your plan's per-project cap

How to Create a project in ChatGPT on Mac in ChatGPT on a Mac

  1. Open the ChatGPT desktop app

    ⌘ Space

    Press ⌘ Space, type ChatGPT, and press Return. Wait for the main window to load and the sidebar to appear. Use the app named ChatGPT, not ChatGPT Classic, unless you need the old projects that live there.

    Tip: Spotlight is the fastest way to open any app on your Mac.

  2. Update the app if Projects is missing

    ChatGPTCheck for Updates

    Click ChatGPT in the menu bar and choose Check for Updates. Builds from the first weeks after the July 2026 rebuild hid the controls. Install the update, then reopen the app.

    Tip: Find your build number under ChatGPT > About ChatGPT.

  3. Find the Projects area in the sidebar

    Look at the left sidebar for the Projects heading. Existing projects sit under it. If the sidebar is collapsed, open it before you look for the heading, and confirm the top-left menu shows ChatGPT, not Codex.

    Tip: Codex history stays separate and does not appear in ChatGPT's Recents.

  4. Select New project

    Select New project in the sidebar. The label should sit near the Projects heading. If you cannot find it, click the filter icon next to Chats and choose Chronological, then look again.

    Tip: ⌘⌥N opens Quick chat, which is a separate feature. It does not start a project.

  5. Enter a project name

    Type a name you will recognize months from now. Put the client, the topic, or the deadline in it, such as Q3 board memo. Keep the name short enough to read in the sidebar without cutting it off.

    Tip: A short, specific name saves you from renaming later.

  6. Choose an icon and color

    Select an icon and a color. The sidebar lists every project you own, so distinct colors make the right one easy to spot. Choose one color for each type of work so the system stays readable.

    Tip: Write your color system down once, then reuse it.

  7. Finish the dialog and open the project

    Confirm the new project, then open it from the Projects heading. Start your first chat from inside the project. Chats started there use the project's instructions and sources.

  8. Write the project instructions

    Describe the job, the reader, the tone, and what to avoid. Keep the instructions to a few short paragraphs. Project instructions apply across its chats, so you only write them once.

    Tip: Re-read the instructions after a month, and cut anything that no longer applies.

  9. Add files or a folder

    Project menuEdit projectAdd folder

    Upload files to the project's Sources section, ten at a time at most. For a folder on your Mac, open the project's menu, select Edit project, then select Add folder. Check your plan's per-project file cap before a large upload.

    Tip: Remote projects currently support one folder.

  10. Pin the project

    Pin the project from the sidebar or the Projects view so you can reach it quickly. Pin only the projects you open every day, so the list stays short enough to scan.

    Tip: Locked chats live under Projects > Locked chats.

A project in ChatGPT is a workspace for one job. It holds the chats, the instructions, and the files that belong together. If you write a weekly report, track a client, or study one topic, a project keeps that work in one place. Without one, your chats pile up in Recents, and you retype the same background every time.

Person at a MacBook learning how to create a project in ChatGPT on Mac
A project keeps related chats and files in one place. · Image by StockSnap from Pixabay

This guide covers the ChatGPT desktop app for Mac. The app was rebuilt in July 2026, and the older version is now called ChatGPT Classic. Menu labels change between builds, so read the steps as a map. Check the labels on your own screen as you go.

What a project holds in ChatGPT on Mac

Every project has three parts. The first is its instructions. Project instructions apply across its chats, so you explain your audience or tone once instead of in every chat. The second is a Sources section, where uploaded files and connected context live.

The third part is folder access, and it applies only to local projects. A local project gives its chats access to one or more folders on your computer. Point it at a folder of notes or drafts, then ask questions about what is inside.

Projects appear in the Projects view of the desktop app. That view holds ChatGPT projects and local projects in one list. You can pin a project from the sidebar or from the Projects view, so the one you use every day is easy to reach.

Before you start: version, account, and ChatGPT Classic

  • Check your build. Click ChatGPT in the menu bar, then choose About ChatGPT. One OpenAI forum user reported build 26.707.62119 on macOS 26.5.2, so your number may differ.
  • Check the account. Workspace and personal histories are separate. If a project is missing, confirm you are signed into the same account you use on the web.
  • Check the mode. The toggle above the message box switches between Chat and Work. The top-left menu switches between ChatGPT and Codex.
  • Keep Classic only if you need it. The old app was renamed ChatGPT Classic, not removed, and it can run alongside the new app.

The rebuild explains most of the confusion. OpenAI folded Codex into the ChatGPT desktop app on July 9, 2026, on macOS and Windows. The existing app became ChatGPT Classic, which 9to5Mac says looks more native to the Mac. Existing Codex app users can update as usual and keep their projects, according to the same article.

Naming projects and picking an icon and color

Pick a name you can scan in a list. A name like Q3 board memo tells you what is inside. A name like Project 1 tells you nothing months later. Put the client, the topic, or the deadline in the name, and keep it short enough to read in the sidebar.

The icon and color do the sorting your eyes need. Pick one color for each type of work. Blue for research, green for drafts, and red for anything with a deadline is a system you can read at a glance. Write the system down once so you keep it as the list grows.

Finding the New project button is where people lose time, because labels move between builds. Lazur can help with that. Hold ⌥ ⌘, ask where the button is, and Lazur draws a circle and a label around it on your screen. Lazur points and explains. It does not click the button for you.

How many files fit in a ChatGPT project

File caps apply per project, not per account. The numbers come from a third party guide that summarizes plan limits. The Free plan allows 5 files per project. Go and Plus allow 25. Pro, Business, Education, and Enterprise allow 40.

Each project also accepts up to 10 files at one time. The guide calls that a batch queueing limit, not a cap on the total. For a large set of files, upload in batches of ten and wait for each batch to finish.

Be careful with Plus. The same guide says OpenAI's File Uploads FAQ lists 20 files for Plus, while OpenAI's Projects article lists 25. Check your plan page before you plan a large upload.

44%

of U.S. adults say they use ChatGPT, in a Feb 2026 Pew survey that also asked about other chatbots

Americans' Views on AI Chatbots, Smart Devices and AI's Impact

5

files per project on the Free plan, per a summary of plan caps

ChatGPT Projects File Limit: Plan Caps and Search Workarounds

40

files per project on Pro, Business, Education, and Enterprise plans

ChatGPT Projects File Limit: Plan Caps and Search Workarounds

10

files can upload at once inside one project on every plan, as a batch queue limit

ChatGPT Projects File Limit: Plan Caps and Search Workarounds

A worked example: one project per client

Man working on a laptop at a desk, sorting files for a client project
One project per client keeps instructions short and clear. · Image by StartupStockPhotos from Pixabay

Say you write a weekly report for several clients. Create one project for each client. In the instructions, write the tone, the report format, and the names of the people who read it. Upload last month's report to Sources.

Now each new chat starts with the same context. You type one short line instead of a long paragraph of background. Across a month of weekly reports, that is a lot of retyping you no longer do.

Keep the file count low. A few well chosen files usually beat a long pile of copies. When a file goes out of date, replace it rather than adding a newer copy beside it, so the project never holds two conflicting versions.

If one client keeps working notes in a folder on your Mac, use a local project. Open the project's menu, select Edit project, then select Add folder. To change the default folder, point to a folder and select Make primary. Remote projects currently support one folder, so plan around that.

When Projects are missing on Mac

This is the most common problem after the July 2026 rebuild. Users reported that Projects were missing from the sidebar until a July 16, 2026 update. Some builds still hide them, so work through these checks in order.

Fixes gathered from a third party guide and user reports.
SymptomWhat to try
Projects heading is missingClick ChatGPT in the menu bar, choose Check for Updates, then reopen the app
Recent chats look emptyClick the filter icon next to Chats and choose Chronological
A chat seems goneCheck Settings > Archived chats. Locked chats sit under Projects > Locked chats
Still missing after an updateSign out, sign back in, and confirm the account matches the one on the web
Old projects gone after updateOne user moved the renamed old app from the Bin back to Applications. That fix is unofficial

The fixes above come from a third party guide and from user reports. An OpenAI Developer Community thread about this bug has no staff reply and no accepted fix. Treat each workaround as a test, and stop when one works.

If nothing works, use ChatGPT Classic for the work that depends on those projects. Keep the new app for everything else. Check for updates again each week, because builds keep changing.

Mistakes people make with ChatGPT projects on Mac

  • Creating a project in the wrong account. Check the account on the web first, then compare it with the app.
  • Looking for a project shortcut. ⌘⌥N opens Quick chat, which is a separate feature. OpenAI's Projects page does not list a project shortcut, so use the sidebar.
  • Uploading everything at once. Batches of ten keep the upload moving.
  • Building one giant project for every job. Split by client or topic so the instructions stay accurate.
  • Ignoring the file cap until an upload stops. Count your files before you start, and remove duplicates.
  • Forgetting about locked chats. Locked chats stay in the account but are hidden from regular chat history, pinned chats, and search.

Keeping projects tidy after you create them

A project works best when you review it every few weeks. Read the instructions and cut anything that no longer applies. Replace old sources with current ones, and keep the file count inside your plan's cap.

If a chat disappears, check Settings > Archived chats before you assume it is gone. Pin the projects you open daily, and leave the rest unpinned so the sidebar stays easy to scan.

Where to go next

If you attach files to ordinary chats too, read How to attach a file in ChatGPT on Mac. For a faster way into ChatGPT from anywhere, read How to use the Option+Space shortcut in ChatGPT on Mac.

If you are deciding between ChatGPT and Lazur for daily work, read ChatGPT on Mac vs Lazur. Lazur is a voice assistant for the Mac. It points at things on your screen and answers out loud. It does not replace the project steps above.

ChatGPT shortcuts for this on Mac

ChatGPT keyboard shortcuts on Mac
To do thisPress
Open Spotlight to launch ChatGPT⌘ Space
Quick chat (a separate feature, not a project shortcut)⌘⌥N

If it does not work

The Projects heading is missing
Click ChatGPT in the menu bar, choose Check for Updates, then reopen the app. Builds from early July 2026 hid the controls.
New project does not appear
Click the filter icon next to Chats and choose Chronological. Then confirm you are signed into the same account you use on the web.
A chat or project seems gone
Check Settings > Archived chats. PIN-locked chats sit under Projects > Locked chats.
Projects are still missing after an update
Sign out, sign back in, and confirm the account. One user reported that moving the renamed old app back from the Bin to Applications restored access. That fix is unofficial.
Upload stops at the file cap
Count the files in the project and compare them with your plan's cap. The Free plan allows 5 files per project, and every plan uploads 10 at a time.

Faster with Lazur

Do it faster: ask Lazur while you are in ChatGPT

Hold ⌥ ⌘ and say what you want. Lazur sees your ChatGPT window. Lazur draws a circle and a label around the button or menu you need.

  • 1

    Hold ⌥⌘ and talk

  • 2

    Lazur draws a circle and a label around the button or menu you need.

  • 3

    You stay in ChatGPT. Nothing to copy into a chat window.

Free for 3 days, then $18/month. Download for Mac

You say“Where is the New project button?”

Lazur · points at itLazur draws a circle and a label around the New project button on your screen, then says where it is out loud.

ChatGPT
New chatSearchNew projectRight hereProjects

Questions people ask

Can I create a project in ChatGPT on the web too?

These steps cover the ChatGPT desktop app for Mac. OpenAI's Projects page describes the desktop app and does not describe creating projects on the web. Check the sidebar in your browser before you assume the steps match.

Is there a keyboard shortcut for creating a project?

No project creation shortcut is documented. The shortcut ⌘⌥N opens Quick chat in the desktop app, which is a different feature. Select New project in the sidebar instead.

How many files can one project hold?

A third party summary lists 5 files per project on Free, 25 on Go and Plus, and 40 on Pro, Business, Education, and Enterprise. Every plan can upload 10 files at once inside a project. One source gives 20 for Plus, so check your plan page.

Why did my projects disappear after the update?

The July 2026 rebuild hid Projects in some builds. Click ChatGPT in the menu bar, choose Check for Updates, and reopen the app. If they still do not show, confirm you are signed into the same account as on the web.

Do project instructions apply to every chat in the project?

Yes. OpenAI's Projects page says project instructions apply across its chats. Chats started outside the project do not get those instructions, so start your work inside it.

Can a project use a folder on my Mac?

Yes, through a local project. Open the project's menu, select Edit project, then select Add folder. Remote projects currently support one folder, so a local project is the better choice for a folder of notes.

Is ChatGPT Classic still available?

Yes. The old app was renamed ChatGPT Classic, not removed. You can find the build number under ChatGPT > About ChatGPT. Some users keep Classic for older projects while they use the new app.

Does Lazur create the project for me?

No. Lazur points at the New project button and explains each step, so you make the clicks yourself. Lazur does not click buttons or operate other apps for you.

Sources

  1. Projects and chats - ChatGPT Learn · OpenAI (ChatGPT Learn) · checked 2026-11-09
  2. ChatGPT desktop app - ChatGPT Learn · OpenAI (ChatGPT Learn) · checked 2026-11-09
  3. OpenAI unveils ChatGPT Work agent, GPT-5.6 models now available - 9to5Mac · 9to5Mac · checked 2026-11-09
  4. ChatGPT Mac App Not Working? How to Fix It (2026) · felloai · checked 2026-11-09
  5. How to keep old ChatGPT projects after the macOS app update · Denis Bouquet · checked 2026-11-09
  6. macOS app does not show chat history or Projects, while web version works normally · OpenAI Developer Community · checked 2026-11-09
  7. ChatGPT Projects File Limit: Plan Caps and Search Workarounds · fileuploadgpt · checked 2026-11-09
  8. Americans' Views on AI Chatbots, Smart Devices and AI's Impact · Pew Research Center · checked 2026-11-09
  9. ChatGPT Release Notes & Changelog · releases.sh · checked 2026-11-09

Try Lazur free for 3 days

Hold a key and ask. Lazur sees your screen, points at the button and talks you through it, in any Mac app. No credit card.