site-activity
Site Activity
Query, analyze, and summarize Webflow site activity logs for enterprise sites. Provides natural-language querying of recent changes, filtered summaries by event type or user, and formatted reports for team sharing.
Important Note
ALWAYS use Webflow MCP tools for all operations:
- Use Webflow MCP's
data_sites_toolwith actionlist_sitesfor listing available sites - Use Webflow MCP's
data_sites_toolwith actionget_sitefor detailed site information - Use Webflow MCP's
data_enterprise_toolwith actionlist_site_activity_logsfor retrieving activity log events - Use Webflow MCP's
webflow_guide_toolto get best practices before starting - DO NOT use any other tools or methods for Webflow operations
- All tool calls must include the required
contextparameter (15-25 words, third-person perspective)
Enterprise Only: Activity logs are only available for sites on Enterprise hosting plans. If the tool returns an error, inform the user that this feature requires an Enterprise plan.
Tool Parameters for list_site_activity_logs:
site_id(required): The site's unique identifierlimit(optional): Maximum records to return (max 100)offset(optional): Pagination offset for fetching beyond the first page
Instructions
Phase 1: Site Selection & Context
-
Identify target site: If the user does not provide a site ID, use
data_sites_toolwith actionlist_sites. Each site in the response hasdisplayName,lastPublished, andlastUpdated.Sort order:
- β οΈ sites (unpublished changes) before β sites (up to date)
- Within each group, most recently updated first (by
lastUpdateddescending)
Truncation: Show the top 10 sites only. If there are more than 10 total, append a line
β¦and N more sites. Reply "show all" to see the rest.below the list. When the user replies "show all" (or similar), re-present the full list in the same format.Present the list in this exact format:
π Site Activity β Site Selection Available Enterprise Sites: 1. <Site Name> β οΈ β last published <short date>, updated <short date> (<N> days unpublished) 2. <Site Name> β β published & updated <short date> 3. <Site Name> β οΈ β never published, updated <short date> β¦and 4 more sites. Reply "show all" to see the rest. Which site would you like to review?Format rules:
- Dates: abbreviated ("Mar 6", "Apr 14"). Add the year only if it isn't the current year.
- Use β οΈ when
lastUpdated > lastPublishedORlastPublishedis null; β whenlastUpdated <= lastPublished. - When
lastPublished == lastUpdated, collapse the right-hand side to "published & updated ". - Omit the "β¦and N more sites" line when the workspace has 10 or fewer sites.
- Do not omit the status flag or the dates β they are required for every site.
-
Fetch selected-site details: After the user selects a site (or when a site ID was provided up front), call
data_sites_toolwith actionget_siteonce, for the selected site only, to retrieve fields not returned bylist_sitesβ in particular:- Custom domains
- Locale / localization settings
- Any additional site metadata needed for the analysis
lastPublishedandlastUpdatedare already known from step 1 (or fromget_siteif the user provided a site ID directly). Keep these in memory for the pre-publish filter in Phase 3. -
Infer intent from the prompt (do not ask a follow-up question if the prompt is clear). Map the request to one of:
- Recent activity summary ("what changed this week?")
- Specific user's activity ("what did Sarah change?")
- Specific activity type ("any CMS changes recently?")
- Pre-publish review ("what's changed since last publish?")
- General overview (default when the prompt is ambiguous)
Only ask a clarifying question if the request is genuinely ambiguous (e.g., "show me activity" with no time window, user, or event type context).
Phase 2: Fetch Activity Logs
- Fetch activity logs: Use
list_site_activity_logswith the site ID- Default to
limit: 100(maximum per request) for comprehensive results - The API returns events in reverse chronological order (newest first)
- Default to
- Handle pagination: If the user needs older activity or the results suggest more data exists:
- Use
offsetparameter to fetch additional pages - Combine results across pages for analysis
- Warn the user if going back further than available data
- Use
Phase 3: Analysis & Summarization
-
Parse each activity log entry: Each event contains:
id: Unique event identifiercreatedOn: Timestamp (ISO 8601)lastUpdated: Last update timestampevent: Event type string (see Event Types below)user: Object withidanddisplayName(absent for system events like backups)resourceOperation: The operation performed (CREATED,MODIFIED,DELETED)resourceId: ID of the affected resource (when applicable)resourceName: Human-readable name of the affected resourcepayload: Additional event-specific details (see Payload Details below)
-
Categorize events into human-readable groups (41 event types):
Page Changes:
page_dom_modifiedβ Page structure/element changespage_createdβ New page creationpage_deletedβ Page deletionpage_duplicatedβ Page duplicationpage_renamedβ Page renamepage_settings_modifiedβ Page settings updates (SEO, slug, etc.)page_custom_code_modifiedβ Page-level custom code changespage_settings_custom_code_modifiedβ Page settings custom code changes
Style & Variable Changes:
styles_modifiedβ Style/class changesvariable_modifiedβ Single variable changevariables_modifiedβ Multiple variable changes
Component Changes:
symbols_modifiedβ Component/symbol created, modified, or deleted
Interactions:
ix2_modified_on_pageβ Interaction changes on a pageix2_modified_on_componentβ Interaction changes on a componentix2_modified_on_classβ Interaction changes on a class
CMS Changes:
cms_itemβ Collection item created, modified, or deletedcms_collectionβ Collection schema created, modified, or deleted
Site Management:
site_publishedβ Site publishedsite_unpublishedβ Site unpublishedsite_custom_code_modifiedβ Site-level custom code changesbackup_createdβ Automatic or manual backupbackup_restoredβ Backup restored
Localization:
secondary_locale_page_content_modifiedβ Localized page content changedlocale_addedβ New locale addedlocale_removedβ Locale removedlocale_enabledβ Locale enabledlocale_disabledβ Locale disabledlocale_display_name_updatedβ Locale display name changedlocale_subdirectory_updatedβ Locale subdirectory changedlocale_tag_updatedβ Locale tag changed
Branches:
branch_createdβ Branch createdbranch_mergedβ Branch mergedbranch_deletedβ Branch deletedbranch_review_createdβ Branch review requestedbranch_review_approvedβ Branch review approvedbranch_review_canceledβ Branch review canceled
Library:
library_sharedβ Library shared with other siteslibrary_unsharedβ Library unsharedlibrary_installedβ Library installed from another sitelibrary_uninstalledβ Library uninstalledlibrary_update_sharedβ Library update publishedlibrary_update_acceptedβ Library update accepted
Note: If an event type not listed above appears, categorize it as "Other" and display the raw
eventstring. -
Apply filters based on user's request:
- By event category (e.g., only CMS changes)
- By user (match on
user.displayName) - By time window (filter
createdOntimestamps client-side) - By resource (match on
resourceName) - Pre-publish review: When the user wants to see changes since the last publish, use the site's
lastPublishedtimestamp (from Phase 1) and filter to events wherecreatedOn > lastPublished. IflastPublishedis null (never published), all events qualify as unpublished.
-
Generate insights (include in the Highlights section of the report):
- Most active user in the time period
- Event type distribution (which category dominated)
- Busiest day or hour
- Single-user concentration (flag when one person made 40%+ of changes)
- Unpublished changes (count of events where
createdOn > lastPublished)
Phase 4: Reporting
-
Generate summary report with these sections:
- Time range covered and total event count
- Breakdown by activity type
- Breakdown by user
- Highlights β call out patterns such as high-frequency changes to a single page/collection, multiple users editing the same resource, unpublished changes (since last publish), and system events vs. user-initiated changes
-
Answer the user's specific question: If the user asked something specific, lead with the direct answer before the structured report.
-
Pick the detail level from the prompt:
- "counts only" / "how many" / "just numbers" β Quick summary (counts by category only)
- default β Standard report (categorized events with user attribution β see Example 1)
- "walk me through" / "show every change" / "timeline" β Detailed report (chronological per-event view with payload)
- "share" / "export" / "for my team" / "summary to send" β Shareable/Export report (see Example 3)
The detail-level switch is always surfaced as one of the follow-up options in step 13 so the user can request a different level.
-
Always end every report with a follow-up options section. This is required, not optional. Use the exact format below, tailoring the numbered options to what's relevant for the query just answered:
--- Would you like to: 1. Filter by a specific user 2. Filter by activity type 3. Fetch older activity (pagination) 4. Switch to a quick summary (counts only) or a detailed view (per-event payloads) 5. Export as markdown or JSONIf the report was a shareable/export format (e.g., "summary I can share"), place this block outside the shareable content so the user can copy the report cleanly without the follow-up menu in it.
Event Payload Details
Different event types include different payload fields:
page_dom_modified:
pageTitle: Name of the modified pagepageId: ID of the modified pagecount: Number of modifications in this batchbranchId/branchName: Branch context (null if main)
cms_item:
cmsCollectionId: ID of the parent collectioncmsCollectionName: Name of the parent collectioncount: Number of items affectedname: Locale name (e.g., "English", "Spanish")
styles_modified:
selector: CSS selector (if applicable)variant: Breakpoint/pseudo-class variant stringparentChain: Array of parent style names (combo class chain)type: Style type (e.g., "class")branchId/branchName: Branch context
symbols_modified:
branchId/branchName: Branch context
page_settings_modified:
pageTitle: Name of the modified pagebranchId/branchName: Branch context
backup_created:
- No payload;
resourceNameindicates backup type (e.g., "Automatic backup", "Maintenance backup") - No
userfield (system-initiated)
Examples
User prompt:
What happened on my site this week?
Step 1: Site Selection
π Site Activity β Site Selection
Available Enterprise Sites:
1. Acme Corp Website β οΈ β last published Apr 14, updated Apr 16 (2 days unpublished)
2. Acme Blog β
β published & updated Apr 10
Which site would you like to review?
Step 2: Activity Summary
π Site Activity: Acme Corp Website
April 10β16, 2026 (93 events)
**93 events this week from 3 team members. 28 are unpublished since the last publish on Apr 14.**
---
## Activity Breakdown
π Page modifications 34 events
π¨ Class changes 22 events
π CMS updates 18 events
π§© Component changes 8 events
π€ Variable changes 5 events
π Publishes 3 events
πΎ Backups 2 events
πΏ Branch activity 1 event
---
## Activity by User
**Sarah Chen** β 42 events
βββ Page modifications (18), Class changes (15), CMS updates (9)
**Alex Kim** β 31 events
βββ CMS updates (9), Page modifications (12), Component changes (8), Variables (2)
**Jordan Lee** β 17 events
βββ Class changes (7), Page modifications (4), Publishes (3), Backups (2), Branch (1)
**System** β 3 events
βββ Backups (auto)
---
## Highlights
- β οΈ **Unpublished changes**: 28 events since last publish (Apr 14)
- π **Busiest day**: April 15 (41 events)
- π€ **Most active**: Sarah Chen (45% of all activity)
- π§© 8 component changes by Alex Kim β may affect multiple pages
---
Would you like to:
1. Filter by a specific user
2. Filter by activity type
3. See details for unpublished changes only
4. Switch to a quick summary (counts only) or detailed view (per-event payloads)
5. Fetch older activity
User prompt:
Show me CMS changes on site 6924868ede9d3fbbc3195eb0
Response:
π CMS Activity: Acme Corp Website
April 10β16, 2026 (18 CMS events)
**18 CMS events from 2 users over 5 days. 3 changes are unpublished.**
---
## CMS Breakdown
π Items modified 11 events
β Items created 5 events
π Collection changes 2 events
---
## Activity by User
**Sarah Chen** β 10 events
βββ 2 items created, 7 items modified, 1 collection modified
**Alex Kim** β 8 events
βββ 3 items created, 4 items modified, 1 bulk publish
---
## Highlights
- β οΈ **Unpublished**: 3 CMS changes since last publish (Apr 14)
- π **Busiest day**: April 15 (8 events)
- π **Schema changes**: 2 collection edits this week (review carefully before publish)
---
Would you like to:
1. Filter to a specific collection
2. Filter by user (Sarah or Alex)
3. See only the unpublished CMS changes
4. Switch to a timeline view (chronological per-event) or counts only
5. Fetch older CMS activity
User prompt:
Give me a weekly summary I can share with my team for Acme Corp Website
(Naming the site inline skips Phase 1 step 1. If the user doesn't name a site, run the site-selection list first before producing this report.)
Response:
π Weekly Site Activity Report
Acme Corp Website β Week of April 10β16, 2026
---
### Overview
- **93 total changes** across 3 team members
- **3 publishes** (Apr 10, Apr 12, Apr 14)
- **28 unpublished changes** pending review
- **Last publish:** April 14 at 18:30 UTC
### What Changed
- 34 page modifications across 8 pages
- 22 class/style updates
- 18 CMS content changes (5 new items, 11 edits, 2 schema changes)
- 8 component updates
- 5 variable changes
### Team Activity
| Team Member | Changes | Top Activity |
|-------------|---------|-------------------------------|
| Sarah Chen | 42 | Page edits, style updates |
| Alex Kim | 31 | CMS content, components |
| Jordan Lee | 17 | Styles, publishing, backups |
### Action Items
- β οΈ 28 changes are unpublished β consider reviewing and publishing
- π§© 8 component changes may affect shared layouts β verify before publish
- πΎ Last backup: April 14 β consider creating a fresh backup
---
Generated from Webflow Site Activity Log
Would you like to:
- Filter to a specific user's changes
- Break down unpublished changes in detail
- Regenerate with a different date range
- Switch to a quick summary (counts only) or detailed per-event view
- Export as JSON instead of markdown
Guidelines
Enterprise-Only Access
Plan Requirement:
list_site_activity_logsis available only on Enterprise hosting plans- If the API returns a permissions error, clearly inform the user:
β οΈ Site Activity Logs require an Enterprise hosting plan. This site does not appear to have Enterprise access. - Do not retry on permissions errors β the issue is plan-level, not transient
API Constraints
Pagination:
- Maximum 100 events per request
- Use
offsetto paginate: first call offset=0, second call offset=100, etc. - 100 events typically covers approximately one week for an active enterprise site
- No native date filtering β all filtering must be done client-side after fetching
When to paginate:
- User asks for more than one week of activity
- User needs a complete picture and first page returns exactly 100 events
- Always tell the user how much data you have: "Showing the last 93 events (Apr 10β16)"
Rate awareness:
- Avoid unnecessary pagination β fetch only what is needed to answer the question
- If user asks "any publishes recently?" β 100 events is likely enough
- If user asks "full month of activity" β explain the limitation and paginate up to 300 events maximum
Error Handling
Common errors:
- 403 / Permission denied: Enterprise plan required β inform user clearly
- 404 / Site not found: Verify site ID, offer to list available sites
- Empty results: Site may have no recent activity β confirm with user and check site details
Graceful degradation:
- If site details fetch fails, still attempt activity logs
- If pagination fails mid-way, report what was successfully fetched
- Always show partial results rather than nothing