Unable to specify a Plugin Icon
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)
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗