All docs
Social Sharing
Paste a link into WhatsApp, Slack, LinkedIn or Facebook and a card appears under it, with a picture, a title and a line of text. The app builds that card from tags in your page's head. When the tags are missing, the app guesses. It picks the first image it finds, which may be a logo from the footer, and a line of text that may be a cookie notice.
Social Sharing writes those tags, so the card is the one you chose. It is the third screen under SEO in the sidebar, with two sub-tabs, Defaults and Networks. Defaults sets what every page falls back to. What one page publishes is shown on Pages, which the Open Pages button at the top right opens.
Defaults

Switch on Enable Open Graph tags first. It is off when you install, and the Open Graph tags need it. The X tags on Networks have a switch of their own.
OG Site Name is the site's name on the card, in the apps that show one, typed as you want it read. Left empty, Joomla's own site name is used.
Default OG Image is the picture for any page that brings none of its own. Choose it with Select, or paste its path into the box under the picture. It works best at 1200 by 630 pixels, which is the shape Facebook and LinkedIn draw. A photograph works far better than a logo here. For a hotel, the front garden in the late afternoon says more than the crest, and a small logo on a wide card looks like a mistake. The test site has no default image yet, which is why the screen shows a warning.
Give it a Default OG Image Alt Text as well, one short sentence a screen reader reads out in its place, such as "The hotel's front garden in the late afternoon". It is written only when the default image is the picture a page shares, never beside a page's own image.
When an article is shared, AI Boost looks for a picture in this order:
- The picture an editor set for this one article, in its sharing fields.
- The article's intro image, or its full article image when it has no intro image.
- The Default OG Image.
A category page tries the category's own sharing image and then the category image before the default. A tag page tries the tag's own image, and a contact page the contact's image when the contact shows it. If no picture is found, the card has none. The screen warns you when no default is set.
Default OG Description Override is one plain sentence, with no tokens. Once filled, it replaces the meta description on the card of every article, the home page and every other menu page. An article keeps a line of its own only when an editor typed one into its sharing fields. A category, tag or contact page that has a description of its own keeps it, cut to the Max Length set on the Descriptions sub-tab of Page SEO. So fill it only with a sentence that fits every page it reaches. For most sites that means leaving it empty, because each page's own description makes a better card than the same sentence under every link.
The override changes the card only. Your meta description stays the page's own, because the {description} token on Page SEO reads Joomla's field and never this one.
Letting editors choose for one article

Each article's card uses its own intro image, or its full article image, and its meta description unless the Default OG Description Override is filled. Use per-article OG image & description, which is on when you install, lets editors override them. AI Boost adds six fields to articles under Content, Fields, Articles, and three to categories under Content, Fields, Categories, so an editor can give one page a different title, line or picture for sharing. They appear on the article's AI Boost tab, and on the category's Open Graph tab, whose name starts with AI Boost. Switch it off and AI Boost ignores what editors typed there, on articles and categories alike. This switch works only on a site that has been activated, as Getting started explains. Until then AI Boost reads none of these fields.
| Field name | What it does |
|---|---|
aiboost_og_title | Replaces the shared title of this one article. Left empty, the card uses the page's own <title>, whether Page SEO wrote it or Joomla did |
aiboost_og_description | Replaces the line under the title |
aiboost_og_image | The picture for this article, ahead of its own image and the default |
aiboost_og_type | What kind of thing the page is. Left on Default, an article page says article while Set og:type = article on article pages is on, and website while it is off |
aiboost_og_video | A video address, starting with http or https, published as og:video for the share card. Facebook may play it in the card. LinkedIn does not say it reads it |
aiboost_twitter_card | Whether X shows a large picture or a small one |
The On this site column says whether each field is in place on your site. Categories get aiboost_cat_og_title, aiboost_cat_og_description and aiboost_cat_og_image, which do the same for a category page. While they are empty, a category page is described by the category's own title, description and image.
The hotel's garden jazz article is titled "First Blog Post" in Joomla, which is a poor thing to see on a card. Its editor typed "Garden evenings at Aldwick Lane Hotel" into the sharing title field and a one-line description under it. The card now reads the way a guest would describe the evening.
These are ordinary Joomla custom fields, so you may change their titles or limit who can edit them. An update sets the options of aiboost_og_type and aiboost_twitter_card back to AI Boost's list, so translate an option with Joomla's Language Overrides or with Falang, which the update leaves as they are. Keep each field's name, because AI Boost finds the field by it. What editors type into them belongs to the article or category, so it is backed up and restored with your Joomla content, not with the AI Boost settings file. If a field has been deleted or hidden, Create or repair the article sharing fields puts it back, and Create or repair the category sharing fields does the same for categories. Neither touches anything your editors typed.

With Set og:type = article on article pages on, an app knows a shared article is an article, so its card can carry the date, the category and the tags. Switched off, every page says website, unless an editor chose another type in the article's aiboost_og_type field. Leave it on unless you have a reason not to. Like the editors' fields, it needs an activated site, and until the site is activated every page says website.
Networks

Locale & Facebook holds Add og:locale tag, which publishes the page's Joomla language as the audience the card is meant for, written as en_GB on the hotel's site. The tag needs an activated site too, while Facebook App ID works on every site. Facebook App ID is the number of your Facebook app, digits only, such as 123456789012345. It costs nothing left empty on a site that has no app.
Twitter / X Cards holds Enable Twitter Card meta tags, which adds the tags X reads, and a few other apps still look for them first. It is off when you install. When a page has a picture, the card is the large one with the picture across the top. A page with no picture gets the small card. Put your brand's X handle, with the at sign, in Twitter / X Site Handle, such as @yourhandle, so a shared card credits you.
What AI Boost publishes
For the hotel's jazz article, with the per-article fields filled in, shortened:
<meta property="og:type" content="article">
<meta property="og:url" content="https://example.com/park-blog/first-blog-post">
<meta property="og:site_name" content="Aldwick Lane Hotel">
<meta property="og:title" content="Garden evenings at Aldwick Lane Hotel">
<meta property="og:description" content="Live jazz, local food and long summer evenings in our London garden.">
<meta property="og:locale" content="en_GB">
<meta property="article:section" content="Park Blog">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Garden evenings at Aldwick Lane Hotel">The card is the small summary one here, because this test page has no picture. Give it one and it becomes summary_large_image.
Check it on your site
The Open Pages button, top right, takes you to Pages. On Check addresses, enter an address and open Share. It reads that page on your site and draws the Facebook and X cards it publishes, fallbacks included, and Code lists the tags behind them.
Apps keep a copy of a card for days. After you change a picture, ask Facebook to read the page again with its Sharing Debugger, and LinkedIn with its Post Inspector.