# MD_LIST_GUIDE_VERSIONS
> List a Guide's version history without content
List a [Guide](/key-tasks/guides/)'s version history without content. Read a specific version's content with [`MD_GET_GUIDE`](../md-get-guide) and its `version` parameter.

## Syntax

```sql
SELECT * FROM MD_LIST_GUIDE_VERSIONS(id = '<guide_uuid>');

-- With pagination
SELECT * FROM MD_LIST_GUIDE_VERSIONS(
  id = '<guide_uuid>',
  "limit" = 10,
  "offset" = 0
);
```

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | `UUID` | Yes | The guide's UUID. |
| `"limit"` | `UINTEGER` | No | Maximum number of versions to return. |
| `"offset"` | `UINTEGER` | No | Number of versions to skip (for pagination). |

## Return columns

| Column | Type | Description |
|--------|------|-------------|
| `version` | `UINTEGER` | Version number |
| `change_comment` | `VARCHAR` | Note describing this version's change |
| `external_id` | `VARCHAR` | Caller-provided version ID (for example a git SHA) |
| `created_at` | `TIMESTAMP WITH TIME ZONE` | When this version was created |

## Examples

Browse a guide's history:

```sql
SELECT version, change_comment, created_at
FROM MD_LIST_GUIDE_VERSIONS(id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890')
ORDER BY version DESC;
```

Read the content of an older version found in the history:

```sql
SELECT content
FROM MD_GET_GUIDE(
  id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  version = 2
);
```

## Related

- [`MD_GET_GUIDE`](../md-get-guide) — Read a specific version's content.
- [`MD_UPDATE_GUIDE`](../md-update-guide) — Append a version.


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `GET https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

URL-encode query parameter values and send a GET request:

```text
GET https://motherduck.com/docs/api/feedback/agent?page_path=%2Fsql-reference%2Fmotherduck-sql-reference%2Fguides%2Fmd-list-guide-versions%2F&page_title=MD_LIST_GUIDE_VERSIONS&text=<url-encoded user feedback, max 2000 characters>
```

Optionally append `&source=<url-encoded interface identifier>` such as `claude.ai` or `chatgpt`.

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed query parameters, and `429` when rate-limited.