Skip to main content
Whether you want to update your agent image in the AI Hub or add a photo in a dashboard Markdown tile, Omni requires a publicly accessible image URL. If you paste in a link that doesn’t represent a public image, Omni may fail to load the image. You can use any host that gives you a direct, public image link. This guide walks through hosting an image on Google Drive and building a link Omni can actually load.

Requirements

  • A Google account you can upload the image to. This guide includes Google-specific instructions, but you can use a different host if you prefer.
  • Organization Admin permissions in Omni, if updating AI branding settings.

Why this happens

Several places in Omni ask for the URL of a publicly hosted image:
  • AI Hub agent image — the URL to agent image field in AI branding settings
  • Organization theme logo and wordmark — the logo and wordmark fields in application theme settings
  • Omni app images - Omni accepts image hosts when building an app, but the image’s host must be added to the app’s External source policy.
These fields expect a URL that:
  • Points directly at an image file, not a webpage that displays an image
  • Is reachable without authentication
  • Doesn’t expire
For example, a regular Google Drive “share” link (.../file/d/{fileID}/view) opens a preview page rather than the raw image, so Omni can’t load it.

How to fix it

You can use any host that gives you a public image link, but this example uses Google Drive:
  1. Upload the image to Google Drive.
  2. Open sharing permissions on the image and set General access to Anyone with the link.
  3. Copy the share link and extract the file ID. In a link like https://drive.google.com/file/d/1AbCDefGhIJkLmNoPQRstuVWxyz/view?usp=sharing, the file ID is the segment between /d/ and /view. In this example, the file ID is 1AbCDefGhIJkLmNoPQRstuVWxyz.
  4. Build a link using Drive’s thumbnail endpoint:
    Replace {fileID} with the ID from the previous step. sz=w640 sets the image width in pixels, which you can adjust if you need a different size.
  5. Paste your new /thumbnail link into the desired location in Omni. In this example, we’ll paste the URL into the URL to agent image field in AI Hub > General > Branding. Omni recommends a square PNG, 128x128 pixels, for best results.

Alternative hosting providers

If you’d rather not use Google Drive, any service that returns a stable, public image URL will work. For example, you can upload an image to imgbb.com and use the direct link it creates.

Next steps

  • AI branding — Additional customization options for the Omni Agent.