useSetOpenInAppUrl redirects it to a canonical URL you set instead.
Example
Opening the carousel fullscreen and using “Open in app” deep-links to the featured product’s page in the web app, instead of reopening the view.Returns
useSetOpenInAppUrl returns a single function.
setOpenInAppUrl
href as the target the host’s fullscreen “Open in app” button navigates to. href is required: an empty or whitespace-only string throws synchronously, before the host is called. The function reference is stable across renders, so it is safe to list in an effect’s dependency array. The promise resolves once the host accepts the URL.
ChatGPT is the only host with this button. On another host, or on a ChatGPT client that does not expose it (the desktop app at the time of writing), the promise rejects with a
NotSupportedError: catch it.Design for the Host
Adapt the view to display mode, theme, and device
useDisplayMode
Read and switch the view’s layout, including fullscreen
useOpenExternal
Open a URL outside the view’s iframe through the host