Custom Code Management

Add, review, and manage inline custom scripts on a Webflow site — analytics, tracking pixels, chat widgets, or any custom JavaScript.

Important Note

ALWAYS use Webflow MCP tools for all operations:

• Use Webflow MCP's webflowguidetool to get best practices before any other tool call
• Use Webflow MCP's datasitestool with action list_sites to identify available sites
• Use Webflow MCP's datascriptstool with action listregisteredscripts to list all registered scripts
• Use Webflow MCP's datascriptstool with action listappliedscripts to list scripts applied to pages
• Use Webflow MCP's datascriptstool with action addinlinesite_script to register a new inline script
• Use Webflow MCP's datascriptstool with action deleteallsite_scripts to remove ALL site scripts (no selective delete)
• Use Webflow MCP's datascriptstool with action getpagescript to get custom code for a specific page
• Use Webflow MCP's datascriptstool with action upsertpagescript to add or update page-level custom code
• Use Webflow MCP's datascriptstool with action deleteallpage_scripts to remove all custom code from a page
• All tool calls must include the required context parameter (15-25 words, third-person perspective)

Instructions

Phase 1: Discovery

1. Call webflowguidetool first — always the first MCP tool call
2. Get the site: Use datasitestool with action list_sites. If only one site, use it automatically.

Phase 2: Analysis

1. List scripts: Call listregisteredscripts and listappliedscripts in parallel
2. Check page-level scripts (if relevant): Use getpagescript for specific pages
3. Present findings: Name, version, location (header/footer), registration vs application status

Phase 3: Planning & Confirmation

Before any mutation, present the plan and require explicit confirmation:

• Adding scripts: user must type "add"
• Removing ALL site scripts: user must type "delete all" (warn: no selective delete)
• Page-level changes: user must type "update"

Phase 4: Execution

1. Add site script: addinlinesite_script with displayName, sourceCode, version, location, canCopy
2. Remove all site scripts: deleteallsite_scripts
3. Add/update page script: upsertpagescript
4. Remove page scripts: deleteallpage_scripts

Phase 5: Verification

1. Re-list scripts to confirm success
2. Report what changed (name, location, version, char count)
3. Remind user to publish — suggest using safe-publish skill

Examples

Example 1: View scripts

User: "What scripts are on my site?"

1. webflowguidetool → datasitestool → listregisteredscripts + listappliedscripts in parallel
2. Present summary of all scripts

Example 2: Add Google Tag Manager

User: "Add GTM to my site"

1. webflowguidetool → datasitestool → ask for GTM container ID
2. Preview script, require "add" → addinlinesite_script (header, version "1.0.0")
3. Verify and remind to publish

Example 3: Remove all scripts

User: "Remove all scripts"

1. webflowguidetool → datasitestool → list current scripts
2. Warn: removes ALL scripts. Require "delete all" → deleteallsite_scripts
3. Verify and remind to publish

Example 4: Page-specific tracking

User: "Add conversion tracking to my thank-you page"

1. webflowguidetool → datasitestool → getpagescript to check existing
2. Preview, require "update" → upsertpagescript
3. Verify and remind to publish

Guidelines

• webflowguidetool always first — before any other MCP tool
• No <script> tags — Webflow adds them automatically
• Max 10,000 characters per script; displayName + version must be unique
• Site-level scripts (addinlinesitescript) apply to all pages; page-level scripts (upsertpage_script) apply to one page
• No selective delete — deleteallsite_scripts removes everything; always list scripts first so user knows what will be lost
• Hosted/external scripts not available via MCP — inline only
• Recommend header for analytics (GA, GTM); footer for chat widgets and non-critical scripts
• If displayName + version exists, suggest incrementing the version
• Always remind users to publish after changes