---
title: Empty
noindex: true
---

<Danger>
  **Legacy Docs:** This page describes our legacy API. It will be deprecated in
  a future version. Please use the [v2 API](/) where possible.
</Danger>

## Basic Usage

Serves as a placeholder, matching no documents. It's useful for testing scenarios or specific edge cases.

<CodeGroup>
```sql Function Syntax
-- Returns no rows
SELECT description, rating, category
FROM mock_items
WHERE id @@@ paradedb.empty();
```
```sql JSON Syntax
-- Returns no rows
SELECT description, rating, category
FROM mock_items
WHERE id @@@ '{"empty": null}'::jsonb;
```
</CodeGroup>

<div className="mt-8" />