/custom-code-management

name: webflow-mcp:custom-code-management
description: Add, review, or remove inline custom scripts on a Webflow site (up to 10,000 chars). Use for analytics, tracking pixels, chat widgets, or any custom JavaScript. Also manages page-level scripts.

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 `webflow_guide_tool` to get best practices **before any other tool call**
• Use Webflow MCP's `data_sites_tool` with action `list_sites` to identify available sites
• Use Webflow MCP's `data_scripts_tool` with action `list_registered_scripts` to list all registered scripts
• Use Webflow MCP's `data_scripts_tool` with action `list_applied_scripts` to list scripts applied to pages
• Use Webflow MCP's `data_scripts_tool` with action `add_inline_site_script` to register a new inline script
• Use Webflow MCP's `data_scripts_tool` with action `delete_all_site_scripts` to remove ALL site scripts (no selective delete)
• Use Webflow MCP's `data_scripts_tool` with action `get_page_script` to get custom code for a specific page
• Use Webflow MCP's `data_scripts_tool` with action `upsert_page_script` to add or update page-level custom code
• Use Webflow MCP's `data_scripts_tool` with action `delete_all_page_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 `webflow_guide_tool` first** — always the first MCP tool call 2. **Get the site**: Use `data_sites_tool` with action `list_sites`. If only one site, use it automatically.

Phase 2: Analysis

3. **List scripts**: Call `list_registered_scripts` and `list_applied_scripts` in parallel 4. **Check page-level scripts** (if relevant): Use `get_page_script` for specific pages 5. **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

6. **Add site script**: `add_inline_site_script` with displayName, sourceCode, version, location, canCopy 7. **Remove all site scripts**: `delete_all_site_scripts` 8. **Add/update page script**: `upsert_page_script` 9. **Remove page scripts**: `delete_all_page_scripts`

Phase 5: Verification

10. Re-list scripts to confirm success 11. Report what changed (name, location, version, char count) 12. Remind user to publish — suggest using `safe-publish` skill

Examples

Example 1: View scripts

**User:** "What scripts are on my site?" 1. `webflow_guide_tool` → `data_sites_tool` → `list_registered_scripts` + `list_applied_scripts` in parallel 2. Present summary of all scripts

Example 2: Add Google Tag Manager

**User:** "Add GTM to my site" 1. `webflow_guide_tool` → `data_sites_tool` → ask for GTM container ID 2. Preview script, require "add" → `add_inline_site_script` (header, version "1.0.0") 3. Verify and remind to publish

Example 3: Remove all scripts

**User:** "Remove all scripts" 1. `webflow_guide_tool` → `data_sites_tool` → list current scripts 2. Warn: removes ALL scripts. Require "delete all" → `delete_all_site_scripts` 3. Verify and remind to publish

Example 4: Page-specific tracking

**User:** "Add conversion tracking to my thank-you page" 1. `webflow_guide_tool` → `data_sites_tool` → `get_page_script` to check existing 2. Preview, require "update" → `upsert_page_script` 3. Verify and remind to publish

Guidelines

• **`webflow_guide_tool` 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 (`add_inline_site_script`) apply to all pages; **page-level** scripts (`upsert_page_script`) apply to one page
• **No selective delete** — `delete_all_site_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