docs: document custom URL actions on Prompt component

Co-Authored-By: Devin Logan <devinannlogan@gmail.com>

Author: devin-ai-integration[bot]

fern/products/docs/pages/changelog/2026-05-01.mdx

@@ -1,9 +1,27 @@
 ---
-tags: ["ai"]
+tags: ["ai", "components"]
 ---
 
 ## API catalog discovery
 
 AI agents, MCP clients, and API catalog crawlers can now discover your APIs automatically. Every Fern Docs site exposes a standards-based ([RFC 9727](https://www.rfc-editor.org/rfc/rfc9727)) `/.well-known/api-catalog` endpoint generated from your visible API Reference navigation.
 
 <Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/ai-features/api-catalog">Read the docs</Button>
+
+## Custom URL actions on the Prompt component
+
+The `<Prompt>` component's `actions` prop now accepts custom action objects with `label`, `url`, and optional `icon` fields alongside the existing `cursor`, `claude`, and `chatgpt` shorthands. Use `{prompt}` in the URL as a placeholder for the URL-encoded prompt body, or let the prompt be appended as a `prompt` query parameter.
+
+```jsx Markdown
+<Prompt
+  title="Identify a houseplant"
+  actions={[
+    "cursor",
+    { label: "Open in Plant ID", url: "https://example.com/plant-id?q={prompt}", icon: "leaf" }
+  ]}
+>
+Given a photo of a houseplant, identify the species and list its top three care requirements (light, water, humidity).
+</Prompt>
+```
+
+<Button intent="none" outlined rightIcon="arrow-right" href="/learn/docs/writing-content/components/prompt#with-a-custom-url-action">Read the docs</Button>

fern/products/docs/pages/component-library/default-components/prompt.mdx

@@ -1,9 +1,9 @@
 ---
 title: Prompt
-description: Display a copyable prompt with optional open-in actions for AI tools like Cursor, Claude, and ChatGPT.
+description: Display a copyable prompt with optional open-in actions for AI tools like Cursor, Claude, ChatGPT, or any custom URL.
 ---
 
-The `<Prompt>` component displays an AI prompt card with an icon, a multi-line prompt preview, a copy button, and optional "Open in" action buttons for AI tools. Add it to any page so readers can copy the instructions or open them directly in Cursor, Claude, or ChatGPT.
+The `<Prompt>` component displays an AI prompt card with an icon, a multi-line prompt preview, a copy button, and optional action buttons for AI tools. Add it to any page so readers can copy the instructions or open them directly in Cursor, Claude, ChatGPT, or any custom URL you define.
 
 Use it in tutorials, quickstarts, migration guides, or any page where you want readers to hand off a task to an AI assistant — for example, scaffolding a project, generating an SDK, or applying a code change.
 
@@ -99,6 +99,38 @@ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quick
 </Prompt>
 ```
 
+### With a custom URL action
+
+Beyond the `cursor`, `claude`, and `chatgpt` shorthands, you can pass a custom action object to point at any AI tool. The `label` is rendered verbatim (no `Open in` prefix), and the `url` accepts an optional `{prompt}` placeholder that's replaced with the URL-encoded prompt body. If you omit `{prompt}`, the prompt is appended as a `prompt` query parameter. Custom URLs must use `http` or `https`. The optional `icon` accepts a [Font Awesome icon](/learn/docs/writing-content/components/icons) name or image URL and falls back to a sparkle icon when omitted.
+
+Custom and built-in actions can be mixed in the same `actions` array.
+
+<div className="highlight-frame">
+  <div className="highlight-frame-content">
+  <Prompt
+    title="Identify a houseplant"
+    actions={[
+      "cursor",
+      { label: "Open in Plant ID", url: "https://example.com/plant-id?q={prompt}", icon: "leaf" }
+    ]}
+  >
+  Given a photo of a houseplant, identify the species and list its top three care requirements (light, water, humidity).
+  </Prompt>
+  </div>
+</div>
+
+```jsx Markdown
+<Prompt
+  title="Identify a houseplant"
+  actions={[
+    "cursor",
+    { label: "Open in Plant ID", url: "https://example.com/plant-id?q={prompt}", icon: "leaf" }
+  ]}
+>
+Given a photo of a houseplant, identify the species and list its top three care requirements (light, water, humidity).
+</Prompt>
+```
+
 ### With a custom icon
 
 Set the `icon` prop to a Font Awesome icon name or image URL.
@@ -189,9 +221,20 @@ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quick
   A [Font Awesome icon](/learn/docs/writing-content/components/icons) name or image URL displayed to the left of the prompt text. Defaults to a sparkle icon when omitted.
 </ParamField>
 
-<ParamField path="actions" type="string[]" default="[]">
-  The "Open in" action buttons to display. Available values: `cursor`, `claude`, `chatgpt`. The first action renders as the primary button. Additional actions are accessible via a dropdown. The copy button is always present regardless of this prop.
+<ParamField path="actions" type="(string | object)[]" default="[]">
+  The action buttons to display. Each entry is either a built-in shorthand (`cursor`, `claude`, or `chatgpt`) or a custom action object with `label`, `url`, and optional `icon` fields. The first action renders as the primary button; additional actions are accessible via a dropdown. The copy button is always present regardless of this prop.
 </ParamField>
+<Indent>
+  <ParamField path="label" type="string" required={true}>
+    The button text for a custom action. Rendered verbatim — no `Open in` prefix is added.
+  </ParamField>
+  <ParamField path="url" type="string" required={true}>
+    The destination URL of a custom action. Use `{prompt}` as a placeholder for the URL-encoded prompt body. If omitted, the prompt is appended as a `prompt` query parameter. Only `http` and `https` URLs are supported.
+  </ParamField>
+  <ParamField path="icon" type="string">
+    A [Font Awesome icon](/learn/docs/writing-content/components/icons) name or image URL displayed in the custom action button. Defaults to a sparkle icon when omitted.
+  </ParamField>
+</Indent>
 
 <ParamField path="hidePrompt" type="boolean" default={false}>
   Hide the prompt body chip. Only the title row with copy and open-in actions is shown. Requires `title` to be set.