Primary navigation

Apps SDK changelog

Latest updates to Apps SDK for building apps in ChatGPT.

March 2026

  • Plugin distribution guidance

    Fixes & improvements

    • Apps SDK docs now explain that OpenAI turns approved apps into plugins for Codex distribution, and that for now plugins are only available in Codex.

  • File library helpers in window.openai

    Fixes & improvements

    • window.openai.selectFiles() lets widgets pick existing files from the user’s ChatGPT file library when that library is available.

    • window.openai.uploadFile(file, { library: true }) lets widgets save uploads into the user’s ChatGPT file library when that library is available.

  • Non-image file uploads

    Fixes & improvements

    • window.openai.uploadFile now supports non-image file types.

February 2026

  • MCP Apps compatibility

    Fixes & improvements

  • Apps SDK updates for redirects, widget descriptions, and follow-up scrolling

    Fixes & improvements

    • window.openai.openExternal({ href, redirectUrl }) supports redirectUrl: false, which prevents the host from appending ?redirectUrl=... to external links.

    • window.openai.setOpenInAppUrl({ href }) is the supported way to override the fullscreen “Open in ” destination; if you do not call it, ChatGPT keeps opening the widget’s current iframe path.

    • openai/widgetDescription is honored during resource construction and takes precedence over resource.description when present.

    • window.openai.sendFollowUpMessage supports a scrollToBottom parameter; it defaults to true, and you can pass false to opt out.

January 2026

  • Company knowledge compatibility guidance

  • Session metadata for tool calls & requestModal template switching

    Fixes & improvements

    • Tool calls now include _meta["openai/session"], an anonymized conversation id you can use to correlate requests within a ChatGPT session.

    • window.openai.requestModal({ template }) now supports opening a different registered UI template by passing the template URI from registerResource.

November 2025

  • Resources updates