---
updatedAt: 2026-06-28T20:00:39.000Z
agentTools:
  projectIndex: https://developers.taboola.com/backstage-api/llms.txt
---

# fallback_url

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Name
      </th>

      <th style={{ textAlign: "left" }}>
        Modifier & Defaults
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        fallback\_url
      </td>

      <td style={{ textAlign: "left" }}>
        * \*Required\*\* (unless a `fallback_file` is uploaded)
      </td>

      <td style={{ textAlign: "left" }}>
        String

        Valid URL string

        Max length: 1000
      </td>

      <td style={{ textAlign: "left" }}>
        The image asset for the *default* image (aka *fallback* image), specified as a **URL**.

        ***

        Either submit a `fallback_url` or upload a `fallback_file`.

        If both are submitted, the API will use the `fallback_file` uploaded.
      </td>
    </tr>
  </tbody>
</Table>

> 📘 Image Guidelines
>
> For the latest *thumbnail image* guidelines and best practices see the <a href="https://help.taboola.com/hc/en-us/articles/115006880507-Title-and-Thumbnail-Best-Practices" target="_blank">Taboola Help Center</a>.

> 📘
>
> For more information, see: [Video Items Overview](https://developers.taboola.com/backstage-api/docs/video-items-overview) and [Create a Video Item](https://developers.taboola.com/backstage-api/reference/create-a-video-item).