Skip to content

Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.

fix(settings): spell out the Webflow site token steps above its field (#1593)

Cihan65d0437e5cc6
diff --git a/web/messages/en.json b/web/messages/en.json
index c652101d8..b08ee52ce 100644
--- a/web/messages/en.json
+++ b/web/messages/en.json
@@ -7965,7 +7965,14 @@
"noCollection": "No collection picked yet.",
"tokenLabel": "Site token",
"tokenPlaceholder": "Paste the site token",
- "tokenHint": "In Webflow: Site settings › Apps & integrations › API access › Generate API token, with Sites: Read and CMS: Read and write. It's kept by our connector service, never shown again.",
+ "tokenSteps": {
+ "label": "How to get a site token",
+ "open": "In Webflow, go to Site settings › Apps & Integrations › API access and click Generate API token.",
+ "name": "Enter a token name (4–80 characters), e.g. “Ansvisor connector”.",
+ "permissions": "Under Permissions, set CMS to Read and write and Sites to Read-only. Leave everything else on No access.",
+ "copy": "Click Generate token, copy the token and paste it into the field below."
+ },
+ "tokenNote": "Webflow shows the token only once. We store it securely and won’t display it again.",
"connect": "Connect",
"connecting": "Connecting…",
"connectedToast": "Webflow connected",
diff --git a/web/src/components/settings/webflow-card.test.tsx b/web/src/components/settings/webflow-card.test.tsx
index 4b108f874..76f4dbb5c 100644
--- a/web/src/components/settings/webflow-card.test.tsx
+++ b/web/src/components/settings/webflow-card.test.tsx
@@ -150,6 +150,24 @@ describe('WebflowCard', () => {
expect(container.textContent).toContain('Collection');
});
+ it('says how to make the token, step by step above its field, and that it’s shown once', async () => {
+ await render();
+ const steps = container.querySelector('ol[aria-label="How to get a site token"]')!;
+ expect([...steps.querySelectorAll('li')].map((li) => li.textContent)).toEqual([
+ 'In Webflow, go to Site settings › Apps & Integrations › API access and click Generate API token.',
+ 'Enter a token name (4–80 characters), e.g. “Ansvisor connector”.',
+ 'Under Permissions, set CMS to Read and write and Sites to Read-only. Leave everything else on No access.',
+ 'Click Generate token, copy the token and paste it into the field below.',
+ ]);
+ const field = container.querySelector('input[type="password"]')!;
+ expect(steps.compareDocumentPosition(field) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
+ const described = field.getAttribute('aria-describedby')!.split(' ');
+ expect(described.map((id) => document.getElementById(id)?.textContent)).toEqual([
+ steps.textContent,
+ 'Webflow shows the token only once. We store it securely and won’t display it again.',
+ ]);
+ });
+
it('says why a token wasn’t taken, and keeps the form', async () => {
client.connectWebflow.mockResolvedValue({ ok: false, code: 'missing_scopes' });
await render();
diff --git a/web/src/components/settings/webflow-card.tsx b/web/src/components/settings/webflow-card.tsx
index a47ef9019..6e4741c2c 100644
--- a/web/src/components/settings/webflow-card.tsx
+++ b/web/src/components/settings/webflow-card.tsx
@@ -253,6 +253,9 @@ export function WebflowCard() {
);
}
+/** Making a site token in Webflow, in order (en.json settings.webflow.tokenSteps). */
+const TOKEN_STEPS = ['open', 'name', 'permissions', 'copy'] as const;
+
/** The site token, pasted once: it goes to the API and is never shown again. */
function TokenForm({
brandId,
@@ -289,10 +292,20 @@ function TokenForm({
}}
>
<Label htmlFor={`webflow-token-${brandId}`}>{t('tokenLabel')}</Label>
+ {/* How to make one, read before the field it's pasted into. */}
+ <ol
+ id={`webflow-token-steps-${brandId}`}
+ aria-label={t('tokenSteps.label')}
+ className="list-decimal space-y-0.5 pl-4 text-xs text-muted-foreground"
+ >
+ {TOKEN_STEPS.map((step) => (
+ <li key={step}>{t(`tokenSteps.${step}`)}</li>
+ ))}
+ </ol>
<div className="flex flex-wrap gap-2">
<Input
id={`webflow-token-${brandId}`}
- aria-describedby={`webflow-token-hint-${brandId}`}
+ aria-describedby={`webflow-token-steps-${brandId} webflow-token-hint-${brandId}`}
type="password"
autoComplete="off"
spellCheck={false}
@@ -317,7 +330,7 @@ function TokenForm({
)}
</div>
<p id={`webflow-token-hint-${brandId}`} className="text-xs text-muted-foreground">
- {t('tokenHint')}
+ {t('tokenNote')}
</p>
</form>
);