Superwall AI

Superwall AI is the assistant built into the dashboard. Ask it how anything in Superwall works, what's in your account, or what your data says, and it goes and finds out: it reads the docs, checks SDK source code, calls the Superwall API for your organization, and runs analytics queries, then answers with links so you can keep exploring.

It's also useful for more than troubleshooting: ask how a paywall is performing or where conversion dropped, and it will pull the data, chart it, and point out what stands out.

Opening it

In the dashboard, Superwall AI is the Ask anything… box at the bottom of most pages. The box shows the name of the page you're on, so the assistant knows what you're looking at.

1. Click Ask anything… at the bottom of the page.
2. Type your question.
3. Press Enter.

The box grows into the chat. To shrink it back to one row, click anywhere else on the page or press Escape. Your chat stays in the box.

Moving the chat

The buttons in the chat's top bar move it around the dashboard:

After you use Dock to side, the ask box opens chats in the side panel, and its button reads Open in side panel. Click Open full screen in the side panel to switch back to full pages.

Organization pages, like the organization Overview, have no full chat page, so the chat opens in the side panel there.

You can also drag the chat by its edge. Drop it on the right side of the window for the side panel, at the bottom for the ask box, or anywhere else to open it as a full page. To put the chat away as a button, drag it to the bottom-right corner. Click the button to bring it back.

What you can ask

• How Superwall works: Concepts, setup, best practices, and SDK behavior. Answers are grounded in the live docs and the SDK source code, and include links to the pages it used.
• Your account: Projects, apps, campaigns, paywalls, products, and entitlements. The assistant reads them through the Superwall API, scoped to your organization.
• Your data: Plain-English analytics questions. It writes and runs queries against your organization's analytics data, the same data behind Query ClickHouse. The suggested prompts in the panel are good starting points: ARPU by user attributes, cancellation timing, converters versus non-converters.

It can also link you directly to the right dashboard page, and search the web when a question needs outside information.

In the dashboard it can also make changes for you, like updating a campaign. It asks you to approve each one first. See Approving changes.

Page context

The chip above the composer shows the page you're on, and it updates as you move around the dashboard. Superwall AI uses it to tailor answers, so "why is this empty?" means something. You can't remove the chip. On the docs site, Superwall AI also reads the content of the page you're viewing, so you can ask about whatever is on screen.

Chats

Your recent chats are listed under Recent chats in an app's sidebar. Click one to pick it up where you left off, or click New chat next to the heading to start a fresh one. Chats are private to you, and teammates never see them. In the dashboard, your chats follow your Superwall account, so you see the same ones in any browser where you're signed in. On the docs site, superwall.com and agents.superwall.com, chats are tied to the browser you use them in. Clearing its site data removes them.

To share a chat with colleagues:

1. Open the chat as a full page.
2. Click Share chat in the top bar.
3. Click Copy link to copy the public link.

On the docs site and superwall.com

The same assistant is available outside the dashboard: the floating bubble in the bottom-right of the docs and superwall.com, and the Ask AI button in the docs search dialog, which hands your search straight to it. Outside the dashboard it answers Superwall questions from the docs and SDK source. When you're signed in to Superwall, it can also answer questions about your own apps, campaigns, paywalls and metrics.

Use it at agents.superwall.com

Superwall AI also has its own page at agents.superwall.com. It's the same assistant, with a sidebar for New chat, Automations, Integrations, Skills and Settings.

It doesn't use your Superwall sign-in. To let it read your account, add a Superwall API key:

1. Open agents.superwall.com.
2. Click Settings.
3. Paste your key into Superwall API key.

If you ask about your account before adding a key, Superwall AI asks you for one in the chat. The key and your chats are tied to this browser, so clearing its site data removes them.

On agents.superwall.com, Superwall AI only reads your account. It can't make changes, even with a key that allows them. To have it make a change, use it in the dashboard. See Approving changes.

Besides your chats, the sidebar has:

• Automations: prompts that run on a schedule, once or on repeat. Click New automation, or ask Superwall AI in a chat to schedule one. Automations also work in the dashboard chat.
• Integrations: connect other accounts, like Gmail, Notion or Linear, so Superwall AI can act in them.
• Skills: add Agent Skills from GitHub for Superwall AI to read and run.

To get a notification when Superwall AI finishes replying, turn on Get notified when a turn finishes, even with this tab closed under the box where you type when you start a new chat. The toggle doesn't show if your browser can't show notifications or blocks them for the site.

Approving changes

Superwall AI can also make changes in your account, like creating a campaign, pausing a placement, or inviting a member. It never makes a change on its own. When it wants to change something, it shows a card in the chat and waits for your answer.

The card shows:

• A plain-language title for the change, like Archive campaign 123. Deletions show the title in red.
• The details of the change. If a change has no card of its own, the card shows the raw API request: method, path, and body.

Click Approve to make the change, or Decline to skip it.

When you approve, the change is sent from your browser with your own signed-in session, so your own permissions apply. The card then shows Done, or the error Superwall returned, and the dashboard refreshes what changed. When you decline, nothing is sent, the card shows Declined, and Superwall AI is told you said no.

Contacting Superwall support

To reach support yourself, open the chat as a full page, click Support (the life buoy icon) in the top bar, then click Contact support.

When Superwall AI can't solve a problem, it can draft a support ticket for you. It offers one when:

• Something looks broken on Superwall's side.
• You ask for a person or for support.
• You need a change only Superwall staff can make, like your login email, organization ownership, billing, deleting data, turning on a feature, or revoking a credential.
• You ask for a feature Superwall doesn't have.

It doesn't offer a ticket for how-to questions, questions it already answered, or problems in your own app code or store setup. If a number doesn't match another source, it first tries to explain the gap, like a different date range, time zone, or sandbox versus production. It offers a ticket only if it can't, and puts both numbers and the queries behind them in the ticket.

The draft appears as a card titled Send to Superwall support: followed by the ticket's title in quotes. The card shows:

• What you need: Your request, in your words.
• Already checked: What Superwall AI looked at, the IDs involved, and any errors it saw.
• Category, and the Organization and App IDs.

Click Send to support to send the ticket, or Not now to skip it. Once it's sent, the card shows Sent to support and Superwall AI gives you the ticket number. Superwall support emails a confirmation to the address you sign in with, and you can reply in that thread to add anything.

The ticket includes the title, what you need, what was already checked, the category, the organization and app, the page you were on (when Superwall AI knows it), your user ID, and the ID of this chat so support can read the conversation. It doesn't include file attachments.

If you click Not now, nothing is sent and the card shows Not sent. Superwall AI won't offer another ticket for the same problem unless you ask. If sending fails, the card shows the error.

Support tickets work in the dashboard. On the docs site and superwall.com, they work only when you're signed in to Superwall, because the ticket is sent with your own session. They aren't available on agents.superwall.com.

Related

• Query ClickHouse: Direct SQL access to the same analytics data Superwall AI queries for you.
• Plugins: Give Claude, ChatGPT, or Codex the same Superwall knowledge and account access.
• Superwall MCP: Manage your account from MCP-compatible AI tools.
• Use Superwall with AI: Every AI tool for Superwall, and which one to pick.