Skip to content
SEOVault AISEOVault AI Docs

Open Graph and Twitter/X Card Settings

SEOvault AI generates Open Graph and Twitter/X Card tags for your homepage, posts, pages, and taxonomy archives. These tags control the title, description, image, and site attribution that appear when a URL from your site is shared on social platforms, messaging apps, or search engines that consume social metadata.

Where to find the social settings

Section titled “Where to find the social settings”

Go to SEOvault AI > General > Social in your WordPress admin. The tab is divided into four sections: Default Social Image, Facebook, X (Twitter), and Other Accounts.

How social tags work

Section titled “How social tags work”

When a page on your site is visited, SEOvault AI outputs a set of og:* tags for Open Graph and twitter:* tags for X. The plugin only outputs these tags on singular posts and pages, the homepage, and taxonomy archives (category, tag, and custom taxonomy pages). No tags are output on generic archive or date pages.

The plugin uses a fallback chain so a shared URL almost always has a complete card:

  • Title: custom Open Graph title → SEO title → post title (or term name for archives)
  • Description: custom Open Graph description → SEO description → auto-generated description
  • Image: custom Open Graph image → featured image → first image in the content → default social image → site logo → site icon
  • URL: permalink for posts, home_url( '/' ) for the homepage, canonical URL for archives
  • Site name: your WordPress site name, output as og:site_name
  • X handle: the site’s X profile, normalized to an @handle and output as twitter:site

In Manual output mode, the plugin stops auto-generating values. If a field is empty, the corresponding tag is not output. In Autopilot mode, the fallback chain runs automatically. In Disabled mode, no social tags are output at all.

Step-by-step: set up your social cards

Section titled “Step-by-step: set up your social cards”
  1. Go to SEOvault AI > General > Social.
  2. Under Default Social Image, click Upload Image and select or upload an image from your media library. Recommended size is 1200 x 630 pixels in JPG or PNG format. This image is used when no featured image or content image is found.
  3. Under Facebook, enter your Site Facebook Page URL (for example, https://www.facebook.com/yourpage). This is used in your Organization schema’s SameAs field and as article:publisher on posts.
  4. Optionally enter an Author Facebook Page fallback URL. This is used when a post does not have a specific author profile set.
  5. Under X (Twitter), select an X Card Type:
    • Summary Large Image – the default; shows a large image above the title and description
    • Summary – a smaller card with a square thumbnail
  6. Enter your Site’s X Profile URL (for example, https://www.x.com/yourbrand). SEOvault AI normalizes this to an @handle and outputs it as twitter:site.
  7. Optionally enter an Author’s X Profile fallback URL for posts without a specific author profile.
  8. Under Other Accounts, add URLs for any other social profiles you want included in your Organization schema’s SameAs field (for example, LinkedIn, Instagram, YouTube).
  9. Click Save Changes at the bottom of the page.

Per-post social overrides

Section titled “Per-post social overrides”

You can override the social title, description, and image for any individual post or page:

  1. Open the post or page in the WordPress editor.
  2. Find the SEOvault AI meta box.
  3. Expand the Social section.
  4. Enter a custom Open Graph Title, Open Graph Description, and/or Open Graph Image.
  5. Enter a Twitter/X Card Title if you want the X card to use a different title than the Open Graph title.
  6. Save or update the post.

These per-post values take priority over the global fallback chain. If you leave them empty, the plugin uses the same fallback chain described above.

Options reference

Section titled “Options reference”
Setting What it controls Output
Default Social Image Fallback image for all shares og:image, twitter:image
Site Facebook Page Official brand page article:publisher on posts, Organization SameAs
Author Facebook Page Fallback author page Used in author schema when no per-author profile is set
X Card Type Layout of X/Twitter cards twitter:card (defaults to summary_large_image)
Site’s X Profile Official brand handle twitter:site (normalized to @handle)
Author’s X Profile Fallback author handle Used in author schema when no per-author profile is set
Other Accounts Additional social profile URLs Organization SameAs

Open Graph tag output

Section titled “Open Graph tag output”

SEOvault AI outputs the following Open Graph tags when a page has at least a title, description, or image:

  • og:type – website for the homepage and pages, article for posts, website for archives by default
  • og:title – the resolved title
  • og:description – the resolved description
  • og:url – the canonical URL
  • og:image – the resolved image
  • og:site_name – your site name
  • og:locale – the current site locale
  • article:publisher – your Site Facebook Page URL, only on posts with og:type of article

Twitter/X Card tag output

Section titled “Twitter/X Card tag output”

The plugin outputs these tags when a page has at least a title, description, or image:

  • twitter:card – summary_large_image or summary. If you choose Summary Large Image but no image is available, the plugin falls back to summary automatically.
  • twitter:title – the resolved title
  • twitter:description – the resolved description
  • twitter:image – the resolved image
  • twitter:site – your normalized site’s X handle

Notes and edge cases

Section titled “Notes and edge cases”
  • Image dimensions: Facebook and LinkedIn recommend 1200 x 630 px for link preview images. X supports both Summary and Summary Large Image formats; Summary Large Image works best with 1200 x 628 px images.
  • Manual mode: If you are running in Manual output mode and leave social fields empty, no Open Graph or Twitter tags are output for that page. Switch to Autopilot if you want the fallback chain to run.
  • X handle normalization: You can enter a full X URL (such as https://www.x.com/yourbrand), an @handle, or a plain username. The plugin converts all of these to @yourbrand for the twitter:site tag.
  • Taxonomy archives: Categories, tags, and custom taxonomies can have their own Open Graph title, description, and image via the term meta box. If those are empty, the plugin falls back to the SEO title/description and the default social image.
  • Social profiles and schema: The Facebook, X, and Other Accounts URLs are also used in your Organization schema’s SameAs field, which helps search engines connect your site with your official social profiles.
  • Debugging shares: Use Facebook’s Sharing Debugger or X’s Card Validator to refresh the cached preview after changing social metadata. These tools fetch the current tags from your live page and show you exactly what each platform sees.
  • No duplicate tags: If another plugin or your theme also outputs Open Graph tags, you may end up with duplicate metadata. Disable the other plugin’s social tags or switch SEOvault AI to Disabled mode if you prefer another tool to handle social cards.
Section titled “Related docs”