Skip to content

Add setting to disable Optimole URL rewriting for social meta tags (og:image / twitter:image) #1178

Description

@pirate-bot

Impact: 75 · Confidence: 95 · Complexity: 40

Description

Problem

Optimole automatically rewrites image URLs inside page head social meta tags (og:image, og:image:secure_url, twitter:image) to Optimole CDN URLs. This can cause social media crawlers (such as Facebook Sharing Debugger, X/Twitter, LinkedIn) to fail to render link preview cards properly. Currently, site owners must add custom PHP filter code (optml_url_post_process) or manually exclude individual image filenames via Exclusions settings to prevent meta tag rewriting.

Desired Behavior

Provide an option in the Optimole WordPress plugin settings (e.g. under Advanced > Exclusions or General settings) to prevent Optimole from rewriting URLs inside social meta tags (og:image and twitter:image) across the site.

Acceptance Criteria

  • Add a toggle setting in the WordPress plugin dashboard under Settings (e.g. "Disable URL replacement in social meta tags").
  • When enabled, Optimole's front-end HTML parser/replacement logic bypasses <meta> tags with property="og:image", property="og:image:secure_url", and name="twitter:image", leaving original media URLs intact.
  • Verify compatibility with popular SEO plugins (Rank Math, Yoast SEO, All in One SEO, SEOPress).

Customer Context

The customer (Douglas, a pro user running a content website) experienced broken Facebook link previews for articles because Optimole rewrote og:image tags to Optimole CDN URLs. The only available workaround in the plugin UI was adding per-image filename exclusions, which is unmaintainable for new articles. The customer requested a dashboard setting or global rule to stop Optimole from rewriting social meta tags in the page head.

Root Cause Analysis

The customer's underlying problem is that social network crawlers (Facebook, Twitter/X, etc.) require standard, un-processed image URLs in Open Graph (og:image) and Twitter Card (twitter:image) HTML meta tags. Optimole's HTML post-processing parser automatically rewrites all image URLs on the page—including those inside head meta tags—to CDN URLs. When social platforms scrape the page, CDN URL parameters or format negotiations can prevent link previews from generating correctly. The plugin currently lacks a user-configurable setting or exclusion rule to preserve original URLs specifically within head meta tags site-wide, forcing users to rely on manual PHP snippets (optml_url_post_process) or tedious per-file exclusions.

Reasoning

The customer is reporting that Optimole automatically rewrites image URLs in Open Graph and Twitter Card social meta tags (, ) to Optimole CDN URLs. When social crawlers (like Facebook) fetch these rewritten URLs, previews can fail or display incorrectly. Currently, there is no setting in the Optimole WordPress plugin dashboard or cloud interface to disable social meta tag URL rewriting. The support agent confirmed this gap ("there isn't a dashboard setting yet to stop Optimole rewriting og:image/twitter:image") and provided a PHP snippet filter workaround. Exclude rules currently require per-image exclusions by filename, which is not scalable for site owners publishing new content continuously. While the customer initially asked if AVIF was forced, the core problem is the lack of a site-wide toggle or rule in Optimole settings to disable social meta tag rewriting. Root cause analysis confirms this is a genuine missing product feature/toggle in the Optimole WordPress plugin (Codeinwp/optimole-wp).


Source: HelpScout #3478424614
Generated by feature-request-triage workflow (ID: feature-request-triage_6acac3cfcf3413.17158397)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions