Wox-launcher/Wox · error · TypeError

Unsupported list preview tail payload: {type(tail)!r}

Error message

Unsupported list preview tail payload: {type(tail)!r}

What it means

Error "Unsupported list preview tail payload: {type(tail)!r}" thrown in Wox-launcher/Wox.

Source

Thrown at wox.plugin.python/src/wox_plugin/models/preview.py:231

            if isinstance(raw_items, list)
            else []
        )

    @classmethod
    def from_preview_data(cls, preview_data: str) -> "WoxPreviewListData":
        """
        Decode the string stored in WoxPreview.preview_data.
        """
        decoded = json.loads(preview_data)
        return cls.from_json(decoded if isinstance(decoded, dict) else {})


def _tail_to_dict(tail: Any) -> Dict[str, Any]:
    if hasattr(tail, "to_json"):
        return json.loads(tail.to_json())
    if isinstance(tail, dict):
        return tail
    raise TypeError(f"Unsupported list preview tail payload: {type(tail)!r}")


class WoxPreviewScrollPosition(str, Enum):
    """
    Enumeration of preview scroll positions.

    Controls where the preview content is scrolled when first displayed.
    """

    BOTTOM = "bottom"
    """
    Scroll to the bottom after preview first shows.

    Use this for content that grows from the top (like logs, chat messages,
    or terminal output) so the user sees the most recent content first.
    """

View on GitHub (pinned to 1659730fcb)

When it happens

Trigger: Thrown at wox.plugin.python/src/wox_plugin/models/preview.py:231 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Wox-launcher/Wox@1659730fcb (2026-08-15). Data as JSON: /api/errors/079841f5c9374f20. Report an issue: GitHub.