How to Deploy a Code Fix

Overview

Once CrawlSage generates a technical recommendation, you can approve and deploy it directly from the dashboard. Our deployment system communicates with your host CMS integration (like WordPress or Shopify) to inject correct tags dynamically. This page details the deploy workflow.

Prerequisites

• A completed website audit report with pending recommendations.
• A connected and active CMS integration (e.g. the CrawlSage WordPress plugin active and verified).

Step-by-Step Guide

1. Open the Recommendations Queue: In your dashboard view, scroll to the "SEO Recommendations" list.
2. Review the Code Diffs: Click "Review Details" on a recommendation card to expand the review workspace. Here you can inspect:
   • Current Tag Value: The raw HTML property detected by the crawler.
   • Suggested Value: The correct tag prepared by the AI engine.
3. Optional - Edit Suggested Code: If you wish to customize the AI-generated titles, description text, or JSON schema keys, click inside the target input fields and edit the values directly.
4. Deploy the Fix: Click the primary "Apply Fix" button. The status changes to Processing as the patch is sent to your website's API.

Expected Result

The tag will deploy, and the card status will update to Applied. CrawlSage immediately launches a verification check in the background to confirm that your website's public HTML renders the updated tag correctly.

Best Practices

• Review High-Risk Changes: While meta tag suggestions are low risk, review complex JSON-LD structured data or redirects recommendations carefully before clicking apply.
• Test a Single Fix First: If you are configuring a new CMS connection, apply a single meta description change first to confirm that the integration channel works.

Common Mistakes

• Deploying on disconnected sites: If you disconnect the WordPress plugin, attempting to apply fixes will result in connection timeouts. Verify the integration status in Settings first.
• Bypassing reviews: Always inspect the visual diff. The AI provides optimal tags, but context edits (like tweaking marketing keywords) should be verified manually.

Troubleshooting

• Fix status changes to "Deployment Failed":
  1. Verify that your CMS plugin has write access to your directory.
  2. Check if host security plugins (like Wordfence or Cloudflare security rules) are blocking incoming API requests from CrawlSage servers.
  3. Consult the Failed Deployment Troubleshooting manual.