Unable to specify a Plugin Icon

Resolved 💬 1 comment Opened Jun 5, 2026 by whitford-olmst Closed Jun 5, 2026

What version of the Codex App are you using (From “About Codex” dialog)?

Version 26.602.40724 • Released Jun 5, 2026

What subscription do you have?

Business ($25/mo)

What platform is your computer?

Darwin 25.5.0 arm64 arm

What issue are you seeing?

I am trying to specify a custom icon for my Plugin.

<img width="1081" height="202" alt="Image" src="https://github.com/user-attachments/assets/165e255c-477b-4815-aeec-921100961e95" />

<img width="1086" height="573" alt="Image" src="https://github.com/user-attachments/assets/2c36a2f4-35fd-4fca-88a0-16c1b3725913" />

I am following Build plugins documentation.

My plugin is distributed through a private Marketplace (a private GitHub Repo). I can see that the plugin is downloading and installing fine (I can inspect the ~/.codex/plugins/cache/olmst-skills/enterprise/2026.06.3/ directory and I can verify the .codex-plugin/plugin.json file and assets directory.

I have tried both png and svg icon files -- neither are working for me.

I have added interface.composerIcon to the .codex-plugin/plugin.json file, like:

{
  "name": "enterprise",
  "version": "2026.06.3",
  "description": "...",
  "skills": "./skills/",
  "interface": {
    "displayName": "Enterprise",
    "shortDescription": "...",
    "developerName": "Olmstead",
    "category": "Productivity",
    "capabilities": ["Interactive", "Read"],
    "composerIcon": "./assets/codex-plugin-icon.png"
  }
}

I have even tried adding interface.logo, but that doesn't seem to do anything either.

What steps can reproduce the bug?

Feedback ID: no-active-thread-019e992d-86b2-7700-84bd-72f7d6fcfe1a

Take a plugin with .codex-plugin/plugin.json and add an interface.composerIcon entry, along with the icon file file in the assets folder, and see if Codex Desktop App shows the icon when managing Plugins.

What is the expected behavior?

I would expect to see my plugin icon, not the default icon.

Additional information

The OpenAI documentation lacks clarity on icon specifics. So far, I have done the following:

  • Canvas size: 512 x 512 pixels
  • Transparent Background
  • png format (but also tried svg -- and would prefer svg in many cases)

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗