SEOmatic

Added

• Ensure that getTransformByHandle() is passed a string

Added

• Added the ability to choose the Asset Transform to apply to images in the sitemap (#1407)

Fixed

• Fixed an issue where the typeId coming in from editing the Content SEO settings was a string, when it needed to be cast to an integer (#1442) (#1368)
• Fixed an issue where the Copy Settings From menu didn't work correctly for multiple entry types (#1368)

Fixed

• Fixed a regression that would throw an exception when attempting to save the security.txt template (#1435)

Changed

• Add PerplexityBot to the default disallow list in robots.txt, as there's no benefit to allowing it to index your site
• Allow locales to be in the format language[_territory] such that the territory is optional
• Ensure that security.txt templates always end with a new line (#1429)

Fixed

• Fixed an issue where a trailing slash would be added to a paginated URL that uses URL parameters and addTrailingSlashesToUrls was true in the General config (#1401)
• Fixed an issue where clicking the SEOmatic CP nav item would result in a 403 exception if the current user didn't have permission to view the SEOmatic dashboard (#1410)
• Fixed an issue where an exception could be thrown when generating a sitemap with assets, and the field mapping was empty (#1425)
• Fixed an issue where the @id in the mainEntityOfPage JSON-LD wouldn't be correct if the identity and creator were not the same (#1431)

Added

• Added the ability to generate a News Sitemap for any Section
• Added an SEOmatic Debug Toolbar Panel setting to Plugin Settings → Advanced that lets you control whether the SEOmatic Debug Toolbar panel is added to the Yii2 Debug Toolbar (if it is enabled)
• Updated to schema.org v26.0, fixes (#1420)

Changed

• Completely revamped the documentation to hopefully make it more accessible & useful (thanks to Matt Stein @ Adjacent)
• PHPstan code cleanup

Fixed

• Fixed an issue that would cause assets in Neo blocks to not appear as images in the sitemap
• Fixed an issue that would cause assets in SuperTable blocks to not appear as images in the sitemap
• Fixed an issue with missing classes in Sitemap helper
• Fixed an issue that would cause text in Neo blocks to not get extracted

Fixed

• Fixed a regression where the robots tag would be set to none for CP requests, which is incorrect, because GraphQL and meta container endpoints are CP requests (#1414)

Added

• Add phpstan and ecs code linting
• Add code-analysis.yaml GitHub action

Changed

• PHPstan code cleanup
• ECS code cleanup

Fixed

• Fixed an issue where DynamicMeta didn't properly take into account that robots can be a comma delimited list of values now (#1399)
• Fixed an issue where a robots setting of none or noindex in the Content SEO settings make it impossible to override the robots setting in an SEO Settings field (#1399)
• Added the unused static to the Tailwind CSS blocklist to avoid a name collision with a Craft CSS class (#1412)
• Added webp and gif as allowed social media image formats now that the social media sites accept them, and guard against no transform existing (#1411)

Changed

• Updated docs to use node 20 & a new sitemap plugin

Fixed

• Fixed overly large debug toolbar pane response size due to repeating inline SVG icons
• Ensure that CP requests and Tokenized requests have robots tag & header set to none (#1394)

Added

• SEOmatic now requires at least Craft CMS ^3.2.0 or later
• Added a EVENT_INCLUDE_SITEMAP_ENTRY event to allow plugins or modules to determine whether entries should be added to the sitemap or not (#1393)
• Allow the config/seomatic.php siteUrlOverride to be set to either a string, or an array of site URLs, indexed by the site handle for overriding complex headless multi-site Craft setups (#1376)

Changed

• Switch over to listening for element changes via Element::EVENT_AFTER_PROPAGATE events instead of Elements::EVENT_AFTER_SAVE_ELEMENT and have it check the Element::$resaving attribute instead of Model::$scenario = SCENARIO_ESSENTIALS to determine whether sitemap queue jobs should be created (#1388)
• If the Site URL Override feature is used, pass along the parameters, too, when building the URL (#950)
• Removed the automatic Google Sitemap ping endpoint, since Google has deprecated it and will be removing it entirely soon (#1392)

Added

• Switch over to Vite ^5.0.0 & Node ^20.0.0 for the buildchain
• The sitemaps now check enabledForSite to determine whether elements should be included in the sitemap (#1388)

Changed

• Remove vestigial queue option from the console command
• Rebrand Twitter to X (Twitter) in all user-displayed text
• Updated the X (Twitter) large image previews to reflect the new style in X (Twitter)

Fixed

• Fixed an issue where the Truncate Description Tags toggle did not work as expected (#1386)
• Fixed an issue where the frontend SEO preview URLs could be wrong if you're using the Site URL Override feature (#950)

Fixed

• Only try the getMatchedElement() optimization when it's not a console request, and surround it with try/catch to catch any potentially thrown exceptions (#1384)

Fixed

• Fixed a regression that could cause an exception to be thrown when editing an entry in the Craft CP (#1385)

Changed

• Try to use Craft's matched element from UrlManager in MetaContainers if looking for an enabled element, the current siteId is being used and the current uri matches what was in the request (#1381)

Fixed

• Fixed an issue where the CanonicalLink would render if the Robots tag contained multiple values (#1378)
• Don't install an event listener for CampaignElement::EVENT_DEFINE_SIDEBAR_HTML unless on Craft 3.7 or later (#1377)
• Fixed incorrect references to SeoEntry in the Campaign SeoElement (#1383)

Added

• Added an SEOmatic debug panel to the Yii2 Debug Toolbar to aid in debugging SEO metadata

Added

• Disallow Google Bard and Vertex AI bots in robots.txt by default, as there's no benefit to allowing it to index your site. ref: https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers#common-crawlers
• Add integration with the Campaign plugin, so Campaign landing pages are automatically recognized by SEOmatic, and get properly mapped metadata

Changed

• Moved the security.txt location to .well-known/security.txt from the server root, and make the bundle updating mechanism preserve user settings in the process (#1353)
• Improved the mapping of elements to SEO Elements by preferring the refHandle from the SEO Element
• Hide the SEO Image / OG Image / Twitter Image mode selectors if transforming is disabled
• Set the twitterImageTransform and ogImageTransform to false by default, since the default is also sameAsSeo and this will result in better default expected behavior (#1364)

Fixed

• Fixed a syntax error in the digitalproductmeta JsonLD Container (#1361)

Fix

• Syntax error in older versions of PHP (#1359)

Added

• Disallow ChatGPT bot in robots.txt by default, as there's no benefit to allowing it to index your site. ref: https://www.searchenginejournal.com/openai-launches-gptbot-how-to-restrict-access/493394/

Changed

• The Plugin Settings -> Tags -> Add hreflang Tags setting now also controls whether hreflang URLs are added to sitemaps (#1340)

Fixed

• Fixed an issue that caused you to be unable to dynamically include/exclude scripts that have body JavaScript via Twig, by unifying the rendering method (#1334)
• Fixed an issue that caused the default Content SEO Site Name Position to not default to Same As Global Site Name Position (#1321) (#1333)

Fixed

• Fixed a regression caused by (#1334) which caused Google Tag Manager noscript template is output with <script> tags around it (#1346)

Fixed

• Fixed an issue where the MetaJsonLd container was not properly cached, which caused a performance issue as well as storing more data in the cache than necessary
• Fixed an issue that caused you to be unable to dynamically include/exclude scripts that have body JavaScript via Twig, by unifying the rendering method (#1334)

Fixed

• Fixed an issue that would cause settings in the Tracking Scripts settings to be wiped out whenever other settings in SEOmatic were saved (#1327)

Fixed

• Bumped the schema version to side-step a Craft bug that would throw an error when running craft/update with a plugin that had a new migration without a schema version change

Added

• Show a deprecation notice on the Google Analytics tracking script setting, with an explanation of it being discontinued
• Added the ability to completely disable scripts from displaying & rendering if they have been discontinued
• Add an announcement if the site is using the soon to be deprecated Google Universal Analytics via SEOmatic

Changed

• Don't try to submit sitemap indexes to search engines if sitemaps are disabled for that section

Security

• Addressed a potential XSS vulnerability when using seomatic.helper.paginate()

Changed

• Have the Site Name Position default to "Same as Global Setting" (#1321)

Fixed

• Revert (this commit) which caused CLI-based GraphQL generation to fail
• Removed vestigial "No Twitter handle has been set" message (#1316)
• Fixed an issue that would cause SEOmatic to ignore the Override lightswitch setting for SEO Settings fields in the context of generated sitemaps

Added

• Added a View Sitemap Index button to SEOmatic → Site Settings → Sitemap (#1085)

Fixed

• Fixed an issue where SEOmatic would cause other plugins to fail to be able to register Twig extensions after it when using the CLI command craft plugin/install --all (#1312)
• Fix cache-busting param on seo images (#1310)
• Fixed an issue where encodeUrlQueryParams wouldn't include the URL's port

Changed

• Ensure that makes sure that alternate site url's also take into account a potential site override url in sitemaps (#1298)
• Use the getSalePrice() for the default Product and DigitalProduct JSON-LD structured data (#930)

Changed

• Removed the requirement that the Site Twitter Handle is set for Twitter cards to be generated (#1275)

Fixed

• Fixed a caching issue that would cause the Main Entity of Page schema type menu to malfunction (#1303)

Added

• Added (Google rich result) in the Main Entity of Page dropdown, for Schema.org types that Google uses for Rich Results
• Add descriptions & links for (pending) and (Google rich result) schemas in the Main Entity of Page dropdown
• Added a caching layer to the Schema helper

Added

• Added support for Doxster field types as pull sources (#1289)
• Added Sitemap Frequency and Priority to Content SEO overview ([#1294]https://github.com/nystudio107/craft-seomatic/issues/1294)

Changed

• Don't disable hreflang tags based on whether the section is included in the sitemap or not (#1285)
• Ensure that the state of the General tab and the override switch is taken into account when determining if robots is disabled in an SEO Settings field for hreflang URLs
• Changed the sitemap submission timeout to be 5 seconds, to avoid lengthy delays if Google cannot be reached for some reason (#1288)
• Add versioning to the docs
• Add Pending types from Schema.org back into the Main Entity of Page dropdown, but mark them as (pending)

Fixed

• Ensure that URL query parameters are properly encoded after being sanitized (#1075)

Added

• Updated to schema.org v15.0, fixes (#1277)

Changed

• Use dynamic docker container name & port for the buildchain
• Update the buildchain to use Vite ^4.0.0
• Refactored the docs buildchain to use a dynamic docker container setup

Fixed

• Fixed an issue where sitemaps would be regenerated even if URLs were disabled for a particular section, in certain circumstances (#1212)
• Removed the check for the now-deprecated layer property in the tree.jsonld schema from schema.org, so that it can be parsed properly

Fix

• Fixed a regression that would cause entry. to not resolve in meta values

Fix

• Fixed an issue where meta tags would not render on a very specific version of PHP (8.1.13) (#1257)

Changed

• Update to use Vite ^4.0.0 for the buildchain

Fixed

• Solspace calendar integration error would throw an exception if you deleted a Calendar (#1259)

Changed

• Fixed the disabled state of SEO Settings Override fields so they look consistent
• Remove the odd Craft modifiedAttributes styling when a field value is changed (#12403)
• Removed the field class from the SEO Settings field wrapper so an additional status-badge isn't injected by Craft
• Fix the styling of the SEO Image, Twitter Image, and FaceBook OpenGraph image in the SEO Settings field when they are not overridden

Changed

• Better styling for the Robots focus ring
• Refactored the docs to use the latest version of VitePress (^1.0.0-alpha.29)

Fixed

• Fixed a regression that caused entries with SEO Settings fields in them to think the entry had changed, when it hadn't (#1239)
• Fixed an issue where the Facebook Opengraph Image Transform Mode would appear in an SEO Settings field, even if it was disabled (#1240)

Added

• Greatly improved the Robots field, allowing you to pick multiple values, and additional values added by Google (#1237)

Changed

• Switch from Webpack to Vite for the plugin asset build system

Fixed

• Handle the case where an asset's dateModified is null (#1234)

Changed

• Switch from Twigfield to Code Editor

Fixed

• Fixed an issue with Twigfield was errantly loaded in SEO Settings fields (#1229)
• Fixed an issue where Include Images & Videos in Sitemap appeared in the SEO Settings field, despite being disabled in the field settings (#1163)

Fixed

• Allow SEOmatic to work (again) with Commerce 2, which doesn't have the assumed GraphQL interfaces available
• Fixed a regression that used str_contains(), which is unavailable on PHP < 8.0 and would throw an error on PHP 7.x (#1221)
• Fix phpcs coding style CI tests

Changed

• Refactored TrackingVarsAutocomplete to use Twigfield ^1.0.12's ability to pass down data via twigfieldOptions rather than relying on the data cache

Changed

• Don't bother invalidating sitemaps via the console command, as it causes them to be regenerated twice
• Use a stale-while-revalidate pattern for sitemap generation, so the old cached sitemap will be served until the new one as been regenerated due to an invalidation (content editing) (#1213)

Changed

• Check both ENVIRONMENT and CRAFT_ENVIRONMENT when attempt to auto-determine the current environment
• Move to using ServicesTrait and add getter methods for services

Fixed

• Fixed an improper docblock typing for the genericImage property on the Entity model (#1193)

Changed

• Add allow-plugins to composer.json to allow CI tests to work
• Handle passed in arrays and ElementQuerys in assetFromAssetOrIdOrQuery()
• Bumped the bundleVersion to ensure that meta bundles are updated with the new settings

Fixed

• Fixed an issue that could case Craft to log deprecation errors; you may need to re-save your Content SEO settings for it to take effect (#1185)
• Display a more accurate environment message if they are manually setting the SEOmatic Environment (#1186)

Changed

• Require nystudio107/craft-twigfield version ^1.0.9
• Add an additional CP route for Solspace Calendar, which allows characters like -'s in their handles (#1170)

Fixed

• Fixed an issue where the ads.txt, humans.txt, robots.txt, and security.txt preview links in the CP would 404 on a site where the primary site URL wasn't a root URL (#1168)
• Fixed an issue with some of the default values in seomatic-config for Twitter meta tags (#1171)

Fixed

• Fixed issues with some of the default values in seomatic-config for the productmeta

Fixed

• Fixed issues with some of the default values in seomatic-config that would cause some meta values to be unparsed (#1164)

Added

• Integrated Twigfield into SEOmatic, so fields that allow Twig expressions now have an editor with full autocomplete of the Craft and SEOmatic APIs
• SEOmatic SEO Settings fields do not utilize the Twigfield editor, to keep things simple for content authors (though they still parse as Twig expressions)
• Switched the default Twig expressions from single-bracket { } to double-bracket {{ }} for consistency's sake in the seomatic-config settings (single-bracket expressions still work, however)

Changed

• The SEO Keywords field no longer uses a tokenized input, to allow for the use of the Twigfield editor
• Updated the docs to add The Meta Cascade to the Overview section to better explain how SEOmatic works

Changed

• Only strip the tokenParm URL parameter from the canonical URL, leaving others intact if explicitly set by the developer (generally query strings should not be in canonical URLs, but there are exceptions)
• Don't provide link to Plugin Settings or allow them to be accessed without permission, or without allowAdminChanges being enabled (#1150)

Fixed

• Fixed an issue where a GraphQL frontendTemplates request for a disabled file results in error (#1156)
• Fix security.txt template (#1154)

Added

• Added Schema.org v14 JSON-LD models, generated via SchemaGen (#1092)

Changed

• Removed Bing from SEARCH_ENGINE_SUBMISSION_URLS due to it being deprecated (#1043)

Fixed

• Don't allow the autocomplete object inspection to recurse infinitely, set a cap of 10 levels deep (#1132)

Changed

• Ensure that the currentSite is set to the requested one when processing headless requests via API endpoint or GraphQL, to ensure things like siteUrl() etc. resolve correctly (#1111)
• Use the native str_contains() over StringHelper::contains() (which is slower, and allocated objects, etc.)

Fixed

• Fixed an issue where the Autocomplete helper could throw an exception if it encountered a ReflectionUnionType
• Fixed an issue with the default Humans.txt implementation of parseEnv() (#1109)

Changed

• Only regenerate sitemaps via queue jobs if they are a result of an invalidation of the sitemap cache (#1098) (#1097)

Fixed

• Fixed an issue where disabled entries could appear in breadcrumbs JSON-LD (#1088)

Fixed

• Fixed an issue that could cause an exception to be thrown during a console request (#1080)
• Fixed an issue in the TwigExpressionValidator class that prevented you from accessing the seomatic. variable in some circumstances (#1076)

Changed

• Added validation rules for metaCacheDuration property on the Settings model
• Change the default email address in security.txt to the placeholder user@example.com
• The ads.txt and security.txt templates are no longer enabled by default, because they require configuration before use (#1077)

Fixed

• Ensure that the metaCacheDuration is normalized to 0 if set to null or 'null'

Changed

• Add parseEnv() to the humans.txt template to parse environment variables/aliases (#1069)

Fixed

• Fixed an issue where "Same as Site Name Position" did not appear on the Global -> Facebook settings for the Facebook OpenGraph Site Name Position Source setting (#1066)
• If paginated URLs are not using a query string, strip the query string from the canonical URL
• Handle an edge-case where a migration didn't work properly to add SECURITY_TXT_HANDLE (#1065)
• Explicitly typecast limit to (int) for Solspace Calendar queries (#1064)
• Fixed an issue where hitting Command-S wouldn't save any changes to edited template code (but clicking on the Save button would) (#1068)

Fixed

• Fixed a typo in the EVENT_AFTER_SAVE_PRODUCTTYPE event name
• Fixed an issue with empty tagAttrs throwing an exception

Added

• Build only the Monaco editor components needed, drastically reducing the assetbundles size
• Added the ability to set <script> tag attributes for tracking scripts

Fixed

• Fixed an issue that could cause an exception if a MetaBundle was malformed (#1058)
• Fix a bug where modifying sites or element containers would not update the corresponding meta bundle settings. (#979)

Fixed

• Delay registering SEO Elements to give other plugins a chance to load first (#654)
• Fixed an issue where textarea fields aren't disabled, and ensure previously hidden fields work as expected (#1049)
• Fixed an issue where the SEO Settings field would display the Twitter Image and Facebook Image even if they were disabled in the field settings (#1047)
• Register GraphQL types after all plugins are loaded, so that we can work with plugins that register their own types (#1037)
• Fix Bing's sitemap submission URL (#1043)

Fixed

• Fixed an issue that would cause an exception to be thrown if an SEO Settings field was added to an unknown/custom Element's field layout (#1031)
• Fixed an issue where you couldn't query for frontend containers from sites other than the current site request via GraphQL (#1039)
• Fixed an issue where Solspace Calendar events would not have the seomatic field on them when using the GraphQL API (#1037)

Added

• Added in the Monaco editor, with autocomplete & hovers for the Craft APIs as well as variables available in the various SEOmatic templates, such as the tracking scripts

Fixed

• No longer attempt to run the Craft queue manually (#10189)
• Generate sitemaps immediately via console command, bypassing the queue job (#10189)
• Use HtmlPurifier to remove HTML instead of strip_tags to prevent errant stripping of content like I <3 Craft (#1024)

Changed

• Check to see if a site is Enabled in Craft CMS > 3.5 to determine whether to generate sitemap URLs & rel="alternate" links (#1023)
• Check to see if a site is Enabled in Craft CMS > 3.5 to determine whether to generate breadcrumbs (#1023)
• Check to see if a site is Enabled in Craft CMS > 3.5 to determine whether a metabundle should be generated/pruned or not (#1023)
• Updated the buildchain to use Node 16
• Updated to Tailwind CSS ^3.0.0

Changed

• Deprecated the frontendTemplateContainer GraphQL field

Fixed

• Eliminated multiple queries to the same asset via a memoization cache in ImageTransformHelper (#1016)

Changed

• Changed the frontendTemplateContainers GraphQL query to frontendTemplates, and made the query inline with the sitemaps queries, returning a filename and contents

Added

• Added the ability to query for sitemaps, sitemapIndexes, and sitemapStyles via GraphQL (#517)
• Added the Always include canonical links regardless of environment setting to Plugin Settings -> Advanced (#1006)

Fixed

• Don't try to run the sitemap queue job immediately if it's the result of an invalidation, only when the actual sitemap is requested via frontend request
• Fix Matomo script URL value by removing the // and / that are in the Matomo docs (#1004)
• Fixed an issue where meta value parsing could fail with unquoted object keys passed in (#1007)
• Fixed the date in the security.txt template

Added

• Added the ability to specify the SEOmatic environment to use with the GraphQL API (local, staging, production)

Fixed

• Ensure URLs with no path work in decomposeUrl() (#1001)
• Make sure the *Sources variables at least exist, for things like the QuickPost widget (#1002)

Changed

• Add an empty value to possible selections for the Robots setting, to allow it to fall back on global settings (#996)

Fixed

• Ensure the FrontendTemplatesContainer exists before accessing it via GraphQL (#1000)
• Render Canonical URL overrides from the SEO Settings field properly via GraphQL requests (#1001)
• Don't show the "SEO Image Transform Mode" text (sans controls) if it's not enabled in the Field Settings (#995)

Fixed

• Disable strict variables during meta value rendering, to mirror the functionality of renderObjectTemplate(). Resolves (#990)

Changed

• Substantial performance increase on element save, because we ensure the sitemap queue job doesn't attach itself to web-based queue runners (#989)
• Changed the core MetaValue parsing method to be faster, also resolves (for real) (#653)
• Remove all references to the now-deprecated object. syntax (though it still functions as usual)

Fixed

• Fixed an issue where the query string would be erroneously stripped from image URLs (#987)

Fixed

• Fixed a regression that could cause sitemap generation via console command to throw an error (#985)
• Fixed an exception that could be thrown on paginated pages that were not the first page

Fixed

• Fixed an issue where the preview in Content SEO would not display the correct information if "Summary from Field" was chosen (#653)

Security

• Sanitize all rendered URLs in an effort to mitigate a potential attack vector on an improperly configured site

Added

• Added support for security.txt in SEOmatic → Global settings
• Added an option to SEOmatic → Plugin Setting → Sitemaps to have items that have a different Canonical URL than the item URL excluded from the sitemap (#983)
• Moved all the sitemap Plugin Settings to their own tab in SEOmatic → Plugin Setting → Sitemaps

Changed

• Ensure that paginated self-referencing hreflang urls match the paginated canonical URL (#984)

Fixed

• Fixed an issue where a tracking script that had no templateString or templatePath could not be saved, showing " Couldn't save tracking settings due to a Twig error." (#981)
• Fixed the default values for Entry meta bundles that were errantly changed to be empty
• Fixed an issue with the SEO Settings field throwing an exception is no $element context was passed in

Security

• Ensure that only files with the extensions listed in allowedFileExtensions General Config setting can be used with the SEO File Link controller
• Sanitize the canonical URL after the absolute URL has been returned, to mitigate poisoned X-Forwarded-Host headers

Fixed

• Fixed a regression that would throw an exception if Commerce was not installed

Added

• Added the ability to automatically include Commerce's variant=XXX URL parameter in the metadata cache key, allowing for unique values per variant (#971)
• Added a allowedUrlParams config setting that allows URL parameters to be manually whitelisted for inclusion in the metadata cache key (#971)
• Added the ability to query for frontend template containers (robots.txt, etc.) via GraphQL or Meta Container API Endpoint

Added

• Added a nicer looking theme for the Twig & JavaScript code editors, and a more pleasant font selection

Fixed

• Fixed an issue where an empty Category (or other element type) could throw an exception when creating the first category item (#973)
• Fixed profiling on certain methods by using endProfile() in the MetaContainers service

Fixed

• Fixed an issue where dynamic meta information wasn't injected during Craft Previews of pages (#954)
• Fixed an issue where the SEO column would all display the same entry due to a caching issue (#970)

Fixed

• Fix a bug where the same ID would be re-used for multiple element select fields. (#965)

Changed

• Further optimized the CP requests by eliminating redundant calls to loadMetaContainers() and also only calling addDynamicMetaToContainers() on headless requests
• Added more fine-grained profiling to the DynamicHelper class

Fixed

• Fix a bug where SEO image settings could be inherited incorrectly (#962)
• Fixed an issue where elements with newly added SEO Settings field wouldn't appear in the sitemap (#964)

Fixed

• Ensure metacontainers are loaded for new elements that have an SEO Settings field in their layout (#960)
• Typecast the setting collection to an array to handle the case of an empty string being returned (#961)
• Instantiate at least the global metacontainers for CP requests, to sidestep regression issues for code that depends on the metacontainers being present (#954) (#960)

Added

• Added a Include Homepage in Breadcrumbs general plugin setting to control whether the generated JSON-LD for Breadcrumbs includes the homepage or not (#957) & (#747)

Changed

• Switch to rawurldecode() to avoid changing + signs into spaces in pull fields (#785)

Fixed

• Don't call loadMetaContainers() explicitly for CP requests (#954)
• Fixed an issue where if you had an SEO Settings field with the Sitemap tab enabled, but did not have Override on, the <link rel="alternate"> would not render (#958)
• Fixed a validation error that wouldn't allow you to save Tracking Scripts that didn't have a body script (#959)
• Fixed a cosmetic issue with the human-readable display of custom sitemaps (#955)

Fixed

• Fixed an issue that could cause an exception to be thrown or CSS to be broken for the Social Media Preview (#953)

Fixed

• Fixed an exception that could be thrown on a frontend form submission (#951)
• Fixed an issue where entry index pages wouldn't auto-refresh after deleting multiple entries (#952)

Added

• Improved the way overrides are handled & displayed in SEO Settings fields by having an explicit Override switch for each setting (#535)
• Scripts are now rendered and checked for Twig errors before they can be saved (#944)
• Robots, Humans, and Ads templates are now rendered and checked for Twig errors before they can be saved (#944)
• Added Pinterest Tag tracking script (#936)

Changed

• Switch from the shorthand format to object format for the search target JSON-LD (#945)

Fixed

• Only default to not generating image transforms immediately if the image is remote and the environment is local dev (#949)
• Fixed an issue where the Robots setting was ignored in SEO Settings fields for sitemap generation if the Sitemap tab was not enabled (#947)
• Don't have useFieldset() return true, as it causes a visual error when resizing the window in Craft CMS 3.7.x

Fixed

• Fixed a regression that caused sitemap generation via console command to fail (#943)

Fixed

• Fixed an issue where Sitemaps::invalidateSitemapCache() wasn't going through the same bottleneck as the sitemap render, and thus wasn't properly hitting the caching layer
• Don't access Craft::$app->getResponse()->statusCode during console requests (#940)

Added

• Added support for pulling from Preparse fields for SEO fields (#927)

Fixed

• Fix an issue where Undefined class constant ‘EVENT_REGISTER_GQL_SCHEMA_COMPONENTS would be thrown if you were running Craft CMS < ^3.5.0 (#933)
• Empty out the entity image settings to ensure the image gets removed if it no longer exists (#760)

Fixed

• Fixed an issue where MedicalBusiness JSON-LD type didn't inherit all of the properties from MedicalOrganization that it should
• Handle per-entry type settings for the sitemap generation (#929)

Added

• Added truncateTitleTags & truncateDescriptionTags settings to control whether the max title / description lengths should be enforced or not (on by default) (#922)

Changed

• Changed the Google & Bing sitemap submission URLs to https (#903)

Fixed

• Handle the case where additionalSitemaps isn't a zero-based index, due to items being deleted from it (#921)

Added

• Add GraphQL schema components for SEOmatic.

Changed

• Switched documentation system to VitePress

Fixed

• Additional Sitemap URLs will now appear only in the Site's sitemap index where they are defined (#897)

Changed

• Strip the query params from next/prev pagination meta tags if we're not using query-string based pagination (#896)
• Ensure that frontend templates are checked first, so things like humans.twig and robots.twig can be overridden (#891)

Fixed

• If sitemaps aren't enabled globally, return nothing for the sitemap index (#895)
• Fixed an issue where an empty transform mode could cause errors generating social image transforms (#892)

Added

• Only add a sitemap to the sitemap index if there's at least 1 element in the resulting sitemap (#873)

Changed

• Have all of the Site Map settings in the SEO Settings field default to empty, so they fall back on the Content SEO value by default (#871)
• Have the image transform modes all default to empty, so they will fall back on the Content SEO value by default (#868)

Fixed

• For paginated pages, re-apply the adjustment to the canonical URL tag as well (#875)
• Handle the case of empty asset ids being passed in from a missing asset source (#882)
• Fixed the verbiage in the Matomo script URL setting (#880)
• Don't call any AssetManager methods in the component init() method during console requests (#885)

Added

• Added support for Matomo Analytics in the Tracking Scripts section

Changed

• Wrap tracking scripts in IFFYs

Fixed

• Ensure assets imported via FeedMe don't end up in a null volume ID (#840)

Added

• Added support for Facebook domain verification via the facebook-domain-verification tag (#856)
• Add proper support for importing assets via Feed Me (#840)
• Google gtag.js is now the first and default option in Tracking Scripts, and a footnote to use it for Google Analytics 4 is included (#788)
• Added support for Fathom Analytics in the Tracking Scripts section (#823)
• Added support for Plausible Analytics in the Tracking Scripts section (#817)

Changed

• Changed how we determine whether environment mappings should be applied to meta items so GraphQL requests will have them applied

Fixed

• For pagination, adjust the canonical URL tag as well as the variable
• Don't strip the query string from paginated canonical URLs

Added

• Added make update to update NPM packages
• Added make update-clean to completely remove node_modules/, then update NPM packages

Changed

• SEOmatic will now register frontend templates even if they request matches no Craft site, but the request is for a document in the root domain that has a file extension, e.g. robots.txt
• Use Tailwind CSS ^2.1.0 with JIT

Added

• Added the .tagAttrs property to all meta items, so you can dynamically add attributes like data- to any of the meta item tags

Changed

• Move the manifest service registration to the constructor
• Guard against a Site that has a null Base URL in loadFrontendTemplateContainers() (#861)

Fixed

• Fixed an issue where the default settings for Content SEO for sections with multiple entry types was set incorrectly (#814) & (#794)
• Fixed the GTag script to use the ??? empty coalescing operator, to prevent empty strings from being used in gtagProperty (#860)

Changed

• More consistent makefile build commands
• Use Tailwind 2.x & @tailwindcss/jit
• Move settings from the composer.json “extra” to the plugin main class
• Don't register any frontend templates if this site has a sub-directory as part of the URL (#859)
• List all sites sitemaps in the robots.txt (#859)

Fixed

• Ensure really long titles are cropped in the sidebar preview
• Fixed the documentation for the EVENT_ADD_DYNAMIC_META event
• If Manually Set SEOmatic Environment is on, ignore devMode in determining the environment
• Fixed issue with global meta bundles not being updated when their version is changed

Fixed

• Fixed a regression with SEO Settings fields using the old ManifestHelper

Added

• Added seomatic.containers to allow access to the MetaContainers service via Twig
• Added seomatic.bundles to allow access to the MetaBundles service via Twig

Changed

• Only include localized versions of elements that are enabled for hreflang tags
• Dockerized the buildchain, using craft-plugin-manifest for the webpack HMR bridge

Added

• Added a Manually Set SEOmatic Environment setting (defaults to off) for people who want to manually set the SEOmatic environment via environment variable

Changed

• Updated build system infra
• Parse the SEOmatic Environment as a variable before displaying it on the dashboard

Fixed

• No longer include any <body> script tags (as in Google Tag Manager) if the entire script meta container is excluded
• The og:locale tag no longer shows the wrong language for headless requests
• Don't link to the settings page if allowAdminChanges is false
• No longer URL decode text that is pulled from another field in SEOmatic

Fixed

• Fixed a typo in the global JsonLDContainer that caused errors to be generated

Changed

• Implemented useFieldset for Craft 3.6

Fixed

• Explicitly parse the seomatic.site.identity.genericUrl so that aliases & environment variables are parsed
• Fixed an issue with PHP 8 and array_walk_recursive() wanting the second parameter to not be passed by reference ( opposite of what the error message states)
• Fix Feed Me mapping and asset-creation

Changed

• Make the canonical URL point to the current page for paginated links ref
• Run the queue via CLI command via QueueHelper::runConsole() to handle queues that don't conform to Craft' s QueueInterface
• Updated Axios to ^0.21.1
• Removed unneeded duplicate og:locale:alternate if it matches the current og:locale
• Don't strip query strings from link rel="canonical" for paginated pages

Changed

• Renamed common.js -> commons.js, which is the correct name, and also will suppress it from appearing in the error logs
• Switch from using ->each() to using craft\db\Paginator to paginate asset query results, to address out of memory issues on massive queries
• SEOmatic now requires Craft CMS 3.1.19 or later

Fixed

• Fixed a regression that caused Script variables to not be parsed as environment variables
• Fixed a bug that could cause Content SEO image settings to not override the global settings properly
• Set the the canonical URL to be the first page of the paginated pages
• Ensure that paginated pages are cached individually, regardless of the addPaginatedHreflang setting

Changed

• Split out vendors & commons chunks

Fixed

• Changed unlimitedStock to hasUnlimitedStock for the Product JSON-LD defaults
• Ensure that the runtime.js is included in the Field Settings and Field

Changed

• Moved the CSS/JS buildchain over to webpack 5
• Updated to latest npm deps

Added

• Added the ability to query the MetaSiteVarsContainer via GraphQL or Meta Container endpoint, to allow accessing things such as the social media sites/urls, and other site-wide information

Changed

• Normalize the script variables by parsing them as environment variables, and trimming whitespace

Changed

• Moved the environment swapping functionality back to MetaItem::init()
• Removed type="text/javascript" from the <script> tags that SEOmatic injects for tracking scripts

Fixed

• Ensured environment settings for robots are not saved to the db

Changed

• Revert "Social image transforms for remote volumes no longer default to not generating the image transforms immediately (they fall back on whatever your system setting is)" because it caused slowdown when working with remote volumes
• Ensure the URLs in the breadcrumbs JSON-LD adheres to the addTrailingSlashesToURls general config setting
• Added better checks for InStock for Product JSON-LD schema

Fixed

• Fixed an issue where SEOmatic could permanently change "robots" to "none" inadvertently in edge-case circumstances
• Fixed an issue where the Main Entity of Page could reset to undesired values
• Use unicode safe string functions to truncate meta values > 4096 characters before parsing them

Added

• Added a --queue flag that can be passed to the seomatic/sitemap/generate flag to cause the sitemap generation jobs to be queued, but not run

Fixed

• Fixed an issue in sitemap generation if an alternate site element had null for a URL
• Fixed awkward spacing on Tracking Scripts environment warning
• Handle clearing caches properly when the homepage is in a structure via __home__ in the slug

Changed

• Ensure that canonicalUrl is always a string

Fixed

• Fixed a regression that would cause a Garnish error on some SEOmatic pages, causing the JavaScript to not operate property

Changed

• Don’t trigger EVENT_INVALIDATE_CONTAINER_CACHES in a console command
• Replace $this:: (??) with self:: globally in the codebase

Changed

• Improved the user-visible sitemap .xsl stylesheet
• Removed SEOmatic name & link from the user-visible Sitemap footer

Fixed

• Fixed an error that could occur if your primary site has no BaseUrl
• Fixed an issue that could result in multiple X-Robots-Tag headers if Craft is setting the header itself (as it does in 3.5.10 or later)
• Fixed an issue where changing Entry Types would cause the SEO Settings field to not display properly

Added

• Added styling to create human-readable sitemaps via .xsl files
• Added hreflang="x-default" to sitemaps if the Include x-default hreflang Tag setting is enabled

Changed

• Ensure that sitemap alternate URLs also do not include trailing slashes on root website URLs if addTrailingSlashesToUrls is false
• Requests for sitemap.xml are now 302 redirected to the actual sitemap rather than serving the same content from both

Fixed

• Fixed an issue where sitemap index alternate tags had unnecessary whitespace in them

Added

• Added seomatic.helper.sanitizeUserInput() in cases where you want to manually sanitize user input

Changed

• Ensure that sitemap URLs also do not include trailing slashes on root website URLs if addTrailingSlashesToUrls is false

Fixed

• Fixed a formatting issue for fields in the SEOmatic Settings pages that showed the number of characters left
• Fixed an issue where the token field wouldn’t be created if keywords had no value
• Fixed an issue where the previews in an SEO Settings field wouldn't match what they should be previewing
• Live Preview and Preview requests now never have their metadata cached

Added

• Added additional unit tests for URL/entity decoding
• Added a new SEO File Link Endpoint Access setting (off by default) to make the feature opt-in

Changed

• Adjusted the logic in the seomatic.helper.isPreview() function to make it more correct

Fixed

• Fixed a formatting issue introduced in Craft CMS 3.5.4 that caused the layout in some of SEOmatic's settings to be incorrect
• Fixed an issue where the "Leave Site?" dialog would come up on the General Settings page, regardless of whether the page changed or not

Security

• Refactored the GraphQL SSTI code to normalize the string via URL/entity decoding it before stripping tags or Twig

Added

• Add unit tests for the Meta Title tag
• Added a unit test for newline insertion in the GraphQL query payload

Changed

• Social image transforms for remote volumes no longer default to not generating the image transforms immediately (they fall back on whatever your system setting is)
• If no title is provided, just use the site name

Security

• Fixed a potential SSTI if the GraphQL API is enabled in Craft, is open to the public, and a specially crafted request is sent to it

Changed

• Handle empty titles and empty site names by not including the separator character
• Trim trailing slashes from absolute URLs unless addTrailingSlashesToUrls is true

Fixed

• Fixed an issue that caused sitemap generation to fail if you're using a non-native queue runner
• Handle invalid sites that have no site group without throwing an exception
• Fixed an issue where you were unable to set the Canonical URL to an environment variable

Fixed

• Added craftcms/cms back in as a dependency so Craft sees updates to the plugin again
• Fixed deprecation errors with Craft CMS 3.5RC1
• Fixed an issue where a regression caused the Include x-default hreflang Tag setting was not respected

Fixed

• Fixed an issue where null could be passed into groupId for the sitemap generation job, causing it to fail
• If a request is a preview request of any kind, set the robots tag to none
• Don’t send any headers for preview requests

Changed

• Check for null to ensure that the SEO Settings field exists when trying to prune properties from it in pruneFieldMetaBundleSettings()

Added

• Added support for automatically adding Content Security Policy ( CSP) nonces to
• Added Fixed Content Security Policy ( CSP) script-src policies that should be added before the nonces
• Added a sanitizeFieldData() that's called when pulling from other Craft fields, to ensure no executable Twig code exists
• Added a unit test for sanitizeFieldData()

Fixed

• Handle trailing slashes properly for generated URLs such as the canonicalUrl
• Fixed an issue where URLs that depended on the canonicalUrl (such as og:url) would be wrong in the Craft CP or via MetaContainer endpoint or GraphQL
• Fixed an issue where an error could be thrown editing Content SEO settings

Added

• Added the Codeception testing framework to SEOmatic
• Added a SSTI Unit Test to SEOmatic that executes on every push to GitHub to verify there are no regressions for CVE-2020-12790

Changed

• Make entity's a VarsModel so they have access to .parsedValue()

Fixed

• Fixed an issue where additional sitemap entries with empty location settings would throw an error

Changed

• Strip the query string from breadcrumb URLs
• Marked the 3.3.0 update as critical
• Ensure that typeId is explicitly typecast, to avoid it being treated as a string

Fixed

• Fixed an issue where the Dashboard wasn't showing the Content SEO Checklist properly
• Fixed an issue where a sitemap might not show up if there were overlapping Section/other ids

Added

• Added support for querying for SEOmatic metadata via GraphQL inside of Entry, Category, and Product queries
• Added environment variable & alias auto-complete for Canonical URL and Entity URL settings
• Added a Referrer setting under Site Settings → Miscellaneous

Fixed

• Fixed an issue where some Sections might not appear in Content SEO if they had overlapping ids
• Display “Select…” instead of “(unknown)” when no Main Entity of Page has been selected

Fixed

• Fixed an issue with Digital Products throwing an error on saving SEOmatic Content SEO settings
• Fixed an issue that could cause an SQL error when saving Content SEO settings on Postgres

Added

• Added support for Digital Products
• Added a Meta Cache Duration setting under Plugin Settings → Advanced
• Added the ability to control anonymous access to the Meta Container & JSON-LD endpoints (with both off by default)

Fixed

• Fixed a namespacing issue for UrlHelper on certain versions of PHP
• Don't call metaBundles->getMetaBundleBySourceId() unless there are no pending plugin migrations
• Fixed an issue where element caches were not broken on element save for elements with __home__ for the URI

Changed

• Wrap the JSON-LD encoding in try/catch to handle malformed characters
• Added exception logging to MetaValue::parseMetaString() to make debugging the error source easier

Fixed

• Fix Content SEO settings display for MySQL with sql_mode=only_full_group_by
• Fixed an issue where the sitemap index could show duplicate section sitemaps

Fixed

• Fixed an issue where the Main Entity of Page could retain stale values in the SEO Settings field
• Fixed an issue with duplicate entries appearing in the Content SEO listing

Fixed

• Fixed an issue with the Content SEO listing not appearing if you are using Postgres
• Ensure that the Content SEO listing paginates property if you have multiple entry types

Added

• Added a new searchable Schema UI selector for finding Main Entity of Page types quickly
• Added support for importing SEO meta info into SEOmatic via FeedMe
• Added support for multiple Entry Types, each of which can have its own SEOmatic settings in Content SEO
• Added a validator for the Duration schema.org type
• Added a “Include Paginated hreflang Tags” setting
• Added a Submit Sitemap Changes plugin setting
• Added emoji support for Sections

Changed

• The MetaLink error ...did not render because it is missing attributes is no longer render as an error, but rather via the info log level, with WARNING - proceeding it
• You can now pass in @type or type for the schema type

Fixed

• Fixed an issue where the Robots setting could be "sticky" when generating sitemaps with SEO Settings fields involved
• If a page has a robots tag that marks it as noindex or none, don't include a canonical URL
• No longer delete caches in response to TemplateCaches::EVENT_AFTER_DELETE_CACHES
• Fixed an issue where SEO previews could have the wrong URLs for multi-site setups

Security

• Fixed a regression where malformed data passed to the metacontainers controller could result in SSTI which leads to information disclosure

Added

• Updated to Schema.org 7.0.3 including SpecialAnnouncement and other types/changes to handle the COVID-19 crisis
• Added several optional properties to the Event schema.org type: eventStatus, eventAttendanceMode, and previousStartDate
• Included the extension schema.org types as well as core schema.org types
• Added eventAttendanceMode and eventStatus with defaults to the Event JSON-LD

Fixed

• Fixed an issue that appears to be a regression in Yii2, which would cause the Opening Hours to be unable to be saved
• Fixed an issue with the Site URL Override feature that could result in a malformed URL

Changed

• Updated to latest npm dependencies via npm audit fix for both the primary app and the docs
• Have the SEO Preview displayed URL reflect the Site URL Override

Added

• Aliases will now auto-suggest in the Site URL Override settings field
• SEOmatic now will replace any stripped HTML tags with a space, so that the text is more readable

Fixed

• The Site URL Override is now parsed for both aliases and environment variables

Security

• Ensure that URLs are urldecoded before attempting to use a RegEx to strip tags from them

Added

• Added batching to sitemap generation so that the memory used is fixed, and no longer dependent on how many sitemap entries are being processed
• Added a Cache-Control header of no-cache, no-store to the 503 w/Retry-After that SEOmatic returns for sitemaps that are still being generated

Fixed

• Fixed regex in sanitizeUrl()

Fixed

• Fixed an issue where hreflang URLs were incorrect if you had different localized URIs per entry
• Take keys into account when comparing defaults with values in SEO Settings fields
• Fixed a regression with the canonical URL when fetched via GraphQL/XHR
• Fixed an issue in which if Globals were used as source to pull from in a multi-site setup, they'd always preview as the default site value

Changed

• Fixed some dates to dateCreated as categories doesn't have postDate

Security

• Fixed an issue where malformed data passed to the metacontainers controller could result in SSTI which leads to information disclosure

Added

• Added the ability to query by site handle via GraphQL (in addition to siteId)

Changed

• Ensure that the x-default hreflang is set to the primary site, not just the first site

Fixed

• Ensure that the GraphQL service has the invalidateCaches() method before attempting to call it (it wasn't added until 3.3.12)

Added

• Added the ability to copy any of the SEOmatic settings from one site to another, to make setup easier
• If robots is set to none in an SEO Settings field, the entry won't appear in the sitemap

Fixed

• Fixed an issue where if you changed the Sitemap Limit to something other than None, then switched it back, you'd get an empty but non-null value for the limit, which didn't play nice with element queries from third party elements
• Preserve numeric 0 values in JSON-LD properties

Security

• Don't include headers for any response code >= 400
• Remove any Twig tags that somehow are present in the incoming URL

Changed

• Make sure that the BreadCrumbsList JSON-LD and link rel="home" tags respect the siteUrlOverride setting

Fixed

• Fixed some minor UX spacing issues on Craft CMS 3.4

Added

• Added seomatic.helper.isPreview and updated the tracking scripts to utilize it, to handle Craft 3.2 deprecation of craft.app.request.isLivePreview
• Added an account column to the Same As URLs so you can store the social media account (if any) along with the URL
• Added seomatic.helper.sameAsByHandle(HANDLE) to retrieve information about one of the Same As URLs by handle

Fixed

• seomatic:dashboard permission is now required for the displaying of the Dashboard

Added

• Added the ability for sitemaps to extract images & video from SuperTable fields
• Added the ability for text to be pulled from SuperTable fields for SEO Descriptions, etc.

Fixed

• Fixed a regression that caused you to no longer be able to put an array of values in the content field of an og:image tag for multiple OpenGraph images
• Fixed a regression that could cause SEO Settings fields to not propagate images properly

Added

• Added rules to MetaJsonLd to allow for mass-setting via .setAttributes() of id, type, and context

Changed

• Eliminated harmless JavaScript errors if a keywords element doesn't exist

Fixed

• Social Media preview targets are now only added if the element has a uri that is not null

Added

• SEOmatic will now send back an array of data in the metaScriptContainer for GraphQL, etc. so that you can get at both the script and bodyScript even if isArray is false
• When an entry is saved, if the value in an SEO Settings field matches the value in Content SEO for that section, the field is set to an empty value to allow for overriding

Fixed

• Fixed an issue where you couldn't change the Facebook OpenGraph Type in Content SEO if you had an SEO Settings field added to that section
• SEO Settings fields no longer defaults to whatever the parent element's Content SEO settings, which fixes the override cascade

Changed

• Saving changes to the SEOmatic settings will now also clear the GraphQL caches on Craft 3.3 or later
• SEOmatic now tracks if sitemap jobs are pushed into the queue, and will release old sitemap queue jobs so that they don't stack up

Fixed

• Fixed an issue where the JavaScript console could have an error logged if there were no keywords
• Make sure twitter:creator and twitter:site are not resolve as aliases

Security

• Throw an exception if an invalid sort field is passed into the actionMetaBundles() controller method, to eliminate a low-impact SQL injection vulnerability

Security

• Fixed a low-impact SQL injection vulnerability

Added

• Added a siteUrlOverride config setting for when you need to override the siteUrl, for instance in a headless GraphQL or ElementAPI setup

Changed

• If a config/seomatic.php file is present, use that as the source of truth for the 'environment' setting
• Refactored the plugin settings into separate tabs to make them easier to use

Fixed

• Removed thousands separator from Product schema

Changed

• Made the robots default to an empty value for SEO Settings fields
• Updated the URL for sitemap submissions to the Bing search engine
• URL encode the query part of the sitemap submissions to search engines

Added

• Added MAX_TEMPLATE_LENGTH to prevent rendering super large object templates

Changed

• Renamed several JSON-LD core types that were using reserved PHP 7 class names
• No longer match disabled elements unless we’re previewing

Changed

• Rolled back a change that could cause the CP and site to slow down on uncached requests

Changed

• Fixed the base image transform to be 'position' => null

Changed

• SEOmatic will now invalidate container caches if they contain pending image transforms
• Enforce the og:locale and og:locale:alternaate formats of xx_XX even for two-character language codes
• Set 'position' => 'null' for the base image transforms

Changed

• If an section has its robots set to none or noindex in Content SEO, don't add it to the sitemap index
• Add a Lowercase Canonical URL setting to Plugin Settings
• Fixed an issue with the DataType JSON-LD type
• Cleaned up the GraphQL type generator

Changed

• The sitemaps and sitemap indexes that SEOmatic generates are now automatically minified
• Added native GraphQL support

Changed

• Fixed an issue with breadcrumbs beyond the first one

Changed

• Fixed an issue where SEOmatic would put multiple sitemap entries for recurring Solspace Calendar events
• Removed errant logging in the Content SEO controller
• Fixed an issue where the script tag caches could be outputting something other than a string
• Updated the Breadcrumbs format to match Google's new format requirements
• More specifically list what happens in local dev & staging environments

Changed

• Fixed an issue where mainEntityOfPage overrides via an SEO Settings field could be the wrong model type

Changed

• Fixed a potential XSS issue if you used {% do seomatic.helper.paginate() %} and there was a malformed query string
• Replaced frontend api route with an actionUrl()

Changed

• Fixed a typo in the environment info popup
• If the SEO image is not on a local volume, avoid a potentially long round-trip by being paranoid, and defaulting to not generating the image transform immediately

Changed

• Cleaned up the title parsing to allow for siteName only titles more cleanly
• If the source asset file is missing, set generateNow to false rather than null, overriding generateTransformsBeforePageLoad
• Maintain the currently selected site between global nav items in the CP sidebar

Changed

• Fixed an issue where SEOmatic would errantly say the environment was disabled
• Parse the SEOmatic environment variable in the environment check
• Preflight to ensure that the source asset actually exists to avoid Craft hanging
• Fix incorrect event type for RegisterSitemapUrlsEvent

Changed

• Added a Environment label on the Dashboard, with explanations for why the environment setting is overridden (if it is)

Changed

• Strip the query string at render time for the canonical link, to ensure any Craft 3.2 token params are stripped

Added

• Added searching, sorting, and pagination to the Content SEO pages

Changed

• Typecast the sourceName and sourceTemplate to a string before validation
• Moved over to a more modern tokenfield library for SEO Keywords

Changed

• Typecast the sourceName and sourceTemplate to a string everywhere, to handle numeric section/template names
• No longer use error and warning log levels for MetaItem debug messages
• No longer use error log levels for MetaTag debug messages

Added

• Added Social Media Preview Target plugin setting
• Added X-Robots-Tag: noindex header to the sitemaps to prevent the sitemaps themselves from appearing in the SERP

Changed

• Fixed an issue with the sitemap generation not respecting an already running queue

Changed

• Fixed an issue where assigning a Rich Text field to a JSON-LD property didn't work
• Added typecast behavior to the MetaBundle model
• Typecast the MetaBundle sourceName to a string

Added

• Added to the cache tag dependencies for the Field's preview data
• Added sourceType to the InvalidateContainerCachesEvent event
• Added siteId and sourceType to the source cache tag dependencies

Changed

• Prevented public accessing of the Social Media Preview
• Added a 📣 in front of the Social Media Preview

Added

• Added Social Media Preview as a Live Preview target on Craft 3.2 or later

Changed

• Do not invalidate meta bundle for drafts and revisions in Craft 3.2 or later

Changed

• If an entry has its robots set to none or noindex, don't add it to the sitemap
• Only append mtime to an SEO image if there are no query params already

Added

• The generated JSON-LD now uses a single root JSON-LD object with the JSON-LD types included in the @graph array

Changed

• Fixed an issue where headers were sent when the corresponding tags were not present
• Fixed an issue that caused SEOmatic to throw an error after you deleted a Solspace Calender calendar
• If we're not in local dev, tell it to generate the transform immediately so that urls like actions/assets/generate-transform don't get cached
• Add an mtime cache busting URL param to all social media images
• The Facebook and Twitter Transform and Transform Mode settings are now visible even if "Same As SEO Image" is selected

Changed

• Fixed an issue where the built JS bundles would error inside of webpack

Changed

• Switched over to startDateLocalized & endDateLocalized for Solspace Calendar defaults
• Fixed an issue with the Breadcrumbs JSON-LD not being generated properly for sites that has a path as part of their URL (e.g. example.com/us/)
• Handle an edge-case where a migration didn't work properly to add ADS_TXT_HANDLE
• Fixed an issue where an error would be thrown if a new Section was created, and you had a site group that had no sites in it
• Fixed an issue where the SEOmatic CSS was affecting the CP CSS
• Fixed the Look up Latitude/Longitude button; it now opens www.latlong.net because Google requires an API key now

Changed

• Added the ability to pass in asArray as a parameter for CraftQL queries to a JSON-encoded array of data back
• Updated build system

Changed

• Updated to schema.org 3.6 with over 900 JSON-LD Structured Data schemas!

Changed

• Added FAQPage schema type from schema.org
• Ensure that URLs with spaces or other non-RFC1738 compliant characters are encoded
• Replace "steps" by "step" in HowTo JSON-LD
• Changed copyrightYear to output just the year
• Fixed an issue with the JavaScript bundle not instantiating for SEO Settings fields
• Updated to latest npm deps

Changed

• Fixed a typecasting issue that caused link rel="alternate" to render for entries that were disabled for a particular site
• Remove pagination via query string for link rel="alternate"
• Remove the pointless Twig_Node_Expression_EmptyCoalesce class

Changed

• Fixed an issue where the new SEO Settings Field implementation could cause images to be duplicated
• Fixed an issue where JSON-LD schema could not be properly overridden via an SEO Settings field
• Fixed an issue where the dynamically populated schema menu would have improper padding in the values

Changed

• Fixed an issue where a Section with no elements in it could cause the Sitemaps queue job to stall
• Fixed Slack & Discord “summary card” CSS

Changed

• Fixed an issue where the Site Setup checklist wasn't accurately reflecting the site settings
• Fixed an issue where trying to create a new section would throw a Type Error, preventing you from doing so

Added

• Added SEO Previews for LinkedIn, Pinterest, Slack, and Discord
• Added the ability to control what SEO Previews appear in the sidebar
• Added CraftQL support for fetching SEOmatic container meta data
• Added support for Solspace Calendar events for custom metadata, JSON-LD, etc.
• SEO Settings fields now default to whatever the parent element's Content SEO settings are when instantiating it
• The Dashboard setup checklists now display checkboxes for items have have been set up properly
• Added a SeoElementInterface to abstract out the support for custom elements

Changed

• Changed paginated rel="alternate" URLs to always point to the first page in other languages, not the paginated page (that may or may not exist)
• Fixed an issue in getLocalizedUrls() so that it handles getElementUriForSite() returning both null and false
• If a meta value with the key of target (used for schema.org SearchActions) doesn't have a { as the first character, it is not parsed as Twig
• Fixed an issue where environment variables in tracking scripts were not parsed

Added

• Added the ??? Empty Coalesce operator to allow for the easy cascading of default text/image SEO values

Changed

• Fix the addXDefaultHrefLang so it doesn’t throw an error if enabled

Changed

• Don't create rel=alternate links for sections that aren't enabled for a site
• Added a new addXDefaultHrefLang setting (which defaults to true) to control whether the x-default hreflang tag is included
• Updated Twig namespacing to be compliant with deprecated class aliases in 2.7.x
• Changed the default Google Tag Manager data layer variable back to the default dataLayer (which it should have been all along)
• Fixed SoftwareApplication JSON-LD object model

Changed

• Added /cache/ to the default paths excluded in robots.txt to auto-exclude the default Blitz /cache/blitz/ path
• SEOmatic now throws a AddDynamicMetaEvent event to give modules/plugins a chance to add any dynamic meta items to SEOmatic's containers
• SEOmatic now throws a InvalidateContainerCachesEvent event whenever it clears its meta container caches, so other plugins/modules can listen in for it
• No longer regenerate sitemaps when a Section is edited and 'regenerateSitemapsAutomatically' => false
• Update the display name of sections, category groups, and products in Content SEO when they are edited

Changed

• Added Environment::determineEnvironment() so SEOmatic is can be smarter about automatically mapping environments
• Allow the SEOmatic Environment plugin setting to be an Environment Variable in Craft 3.1 or higher
• Allow for Section handles that are longer than 64 characters
• Fixed an issue where the mainEntityOfPage could reset to the default WebPage if you saved the settings on panes other than General
• Fixed an issue with paginated rel="alternate" links on a multi-site setup where the slugs differed from site to site

Changed

• Use dash instead of underscore for sitemap urls
• Don't allow editing of the plugin settings if allowAdminChanges is false
• Sort Content SEO listings by name to make things easier to find
• Add missing properties to the Question JSON-LD schema

Changed

• Fixed an issue where container.clearCache wasn't using the correct cache key to invalidate the cache
• Fixed an issue where Google Tag Manager would render in Live Preview
• Added try/catch around alias/parseEnv to try to catch errors that shouldn't happen

Changed

• Fixed an issue with the URL in the sitemap index to the custom sitemap was invalid
• Fixed an issue when using the meta containers controller with tracking scripts and asArray=true

Changed

• Fixed an issue in Content SEO if no field layouts are yet defined
• Fixed a regression where pagination info is stripped from hreflang
• Add JSON_HEX_TAG flag for encoding JSON-LD to ensure that < & > are escaped
• Addressed an issue where you couldn't set the Main Entity of Page to nothing in Content SEO settings

Changed

• Fixed an issue where .env vars were not actually parsed for the Tracking settings

Changed

• If you're using Craft 3.1, SEOmatic variables/fields are parsed for environment variables as well as aliases
• All tracking fields auto-complete .env environment variables

Changed

• Fixed an issue with sitemap generation if your Section had a Neo field in it
• Fixed an issue if you passed in no parameters to seomatic.helper.getLocalizedUrls() could cause the incorrect localized URLs to be returned
• Removed errant error logging

Added

• Added a SEO Setup checklist to the Dashboard
• Added support for pulling content from Neo fields

Changed

• Fixed an issue where the generated hreflang URLs were wrong if you had localized slugs
• Sitemaps now return a 503 Service Unavailable an a Retry-After so bots will try back later if for some reason they can't be rendered for the current request (Async Queue generation, etc.)
• Fixed a namespacing issue with UrlHelper
• Handle the case where no sections have been set up yet more gracefully

Changed

• Register cache options for every type of request
• Refactored the sitemaps and sitemap indexes to always be in the server root, as per the sitemaps spec

Changed

• Ensure that title truncation handles edge cases gracefully
• Breadcrumbs in the CP now maintain the selected site
• Parse sitemaps and sitemap URLs for aliases and as Twig templates
• Don't try to add assets with null URLs to sitemaps

Added

• Added the ability to add additional sitemaps that exist out of the CMS into the sitemap.xml via Site Settings -> Sitemap as well as via plugin

Changed

• Fixed an issue where LocalBusiness JSON-LD type didn't inherit all of the properties from Place that it should
• Fixed an issue with seomatic.helper.getLocalizedUrls not working as expected for routes other than the current request
• Fixed an issue where plugin-generated custom sitemap URLs didn't have their lastmod respected for the sitemap index
• Fixed an issue accessing metaBundleSettings in the Field when it doesn't exist

Changed

• Fixed an issue where the potentialAction JSON-LD for the Site Links Search was rendered even if it was left empty
• Fixed an issue where the SEO Settings field did not properly override the mainEntityOfPage

Added

• Added a level 2 cache on the controller-based API requests for meta containers to improve "headless" performance
• Added support for LinkedIn Insight analytics in Tracking Scripts
• Added support for HubSpot analytics in Tracking Scripts
• Display the status of tracking scripts in the listing section
• Allow editing of the tracking scripts body scripts

Changed

• Added the Open Graph tag og:site_name
• Removed craftcms/vue-asset composer dependency
• Call App::maxPowerCaptain() whenever a queue is manually run (both via web and console request)

Changed

• Fixed an issue with socialTransform() throwing a Twig exception

Added

• Added <title> prefixes for the Control Panel and devMode Control Panel
• Allow social media images to be either .jpg or .png formats

Added

• Added a console command ./craft seomatic/sitemap/generate to generate sitemaps via the CLI
• Added the SEOmatic->Plugin setting Regenerate Sitemaps Automatically to control the automatic regenerate of sitemaps

Changed

• Fix division by zero error if no sections exist
• Dynamically base the Twitter transform type from the current evaluated type, rather than hardcoding it

Added

• Added support for the ads.txt Authorized Digital Sellers standard

Changed

• Clear FastCGI Caches upon sitemap generation
• If runQueueAutomatically is true return the generated sitemap immediately via http request
• Adjusted Control Panel dashboard charts
• Fixed an issue where the Content SEO settings would display sections that are not enabled for a given site

Changed

• Added the ability to show SEO Settings fields in the Element Index's Table Columns
• Redid the Dashboard graphs to be more useful and modern looking
• Modernized package.json and webpack build
• Confetti on install (yay!)

Changed

• Remove __home__ from preview URIs
• Fixed a regression that caused the SEO Settings field to not override things like Facebook/Twitter images properly
• Fixed an issue that caused the SEO Settings field to not display tabs properly if the General tab was hidden

Changed

• Fixed an issue where sitemaps generated in the Control Panel did not have the proper cache duration set, so they were always invalidated
• Disabled tracking scripts from sending Page View data during Live Preview
• Ensure background image values are quoted for the SEO previews
• If runQueueAutomatically is set, start running the queue job to generate the sitemap immediately

Changed

• Don't regenerate the sitemaps when elements are being re-saved enmasse via Section resaving
• Fixed JavaScript console error due to outdated assets build

Added

• Moved sitemap generation to a queue job, to allow for very large sitemaps to be generated without timing out

Changed

• Normalize the incoming URI to account for __home__

Added

• Added the ability to control the depth that sitemaps should be generated for Categories (just like already existed for Structures)
• Added EVENT_INCLUDE_CONTAINER event to manipulate containers
• Always create sitemap URLs from the given site, since they have to have the same origin
• Added labels to the Google, Twitter, and Facebook previews

Changed

• Fix rendering for MetaLink and MetaTag with multiple tags when requesting them via Controller
• Fixed an issue where SEO Settings fields would override the Sitemap settings even if that was disabled
• Fixed an issue with the SEO Settings field when switching between Entry Types
• Pass down the $uri and $siteId to addDynamicMetaToContainers() to addMetaLinkHrefLang()
• Fix rendering of canonical and home links from Controllers
• Fixed an issue with there Dashboard charts could be out of sync if sections were deleted/renamed
• Use the default transform mechanism for SEO images
• Only include the fields the user is allowed to edit in the SEO Settings overrides
• Fixed an issue where Twitter images could be resized improperly based on the card type

Changed

• Returns the correct sitemap.xml for multi-site "sister site" groups
• Cache frontend templates on a per-site basis
• Make sure that humans.txt links are full URLs
• Handle the case where all Same As URLs are deleted
• Fixed an issue where hreflang tags were still added even with the setting was disabled, but only for paginated entries
• Changed the default title length to 70 and the default description length to 155
• Fixed an issue where nested JSON-LD objects would contain erroneous key and include properties

Changed

• Fixed an issue where choosing All for sitemap Structure Depth resulted in it displaying nothing
• Fixed an issue with the SiteLinks Search Box not having the correct format in query-input
• Fixed an issue where Craft could sometimes hang if we asked for an image transform with generateNow = true

Added

• Added the .clearCache property to all meta containers, allowing them to be manually cleared via Twig
• Don't include any dynamic metadata for response codes >= 400

Changed

• SEOmatic will now automatically take the dataLayer property into account for the script container's cache key
• Better document titles for SEOmatic Control Panel pages
• Remove vestigial Redirects classes
• Don't check the response statusCode for console requests

Added

• Added memoization cache to the FieldHelper class to help improve inner loop performance
• Add the ability to control structure depth for sitemaps

Changed

• For requests with a status code of >= 400, use one cache key

Changed

• Changed the Composer dependency for davechild/textstatistics to lock it down to 1.0.2 Semver?

Changed

• Fixed an undefined index error

Added

• Added the Site Groups define logically separate sites Plugin Setting to allow for different Site Group use-cases

Changed

• Removed potential duplicates from og:locale:alternate
• Don't include alternate or og:locale:alternate tags for Content SEO sections that have Sitemaps disabled
• Handle disabled sections for sites in Content SEO better

Changed

• Fixed an error trying to access a property of a non-object in MetaContainers.php
• Prevent classname conflict with older versions of PHP
• Fix an issue where transform modes didn't work with Custom Image sources
• Scale the logo to fit to 600x60 as per Google specs

Changed

• Handle elements that don't exist on other sites better
• Don't include hreflang in sitemaps for sites where it has been disabled, whether through Content SEO or SEO Settings field settings
• Hide Transform Image and Transform Type in the SEO Settings field if they aren't enabled
• Fixed a conflicting use \craft\helpers\Json import

Changed

• Fixed an issue where sitemap caches were not getting properly cleared
• Fixed an issue where elements disabled in a site were showing up in the hreflang
• Fixed namespaces and custom sitemap event triggering

Added

• Added in the ability to override sitemap settings on a per-Entry/Category Group/Product basis
• Implement Json::decode() to avoid large integers being converted to floats
• If the SEO Settings field for an entry has Robots set to none or has sitemaps disabled, it isn't included in the hreflang
• Added a setting to control whether hreflang tags are automatically added

Changed

• Ensure that the sitemap index cache gets invalidated when entries are modified
• Specify rel="noopener" for external links.
• Fix the order that the field migration happens to let the mapping magic happen
• SEOmatic now requires Craft CMS 3.0.20 or later
• Fixed an issue with paginated pages that have no results on them

Changed

• Fixed a potential undefined index error with pull fields, resulting from the new cropping modes

Added

• Added the ability to choose between Crop (the default), Fit, or Stretch for the SEO, Twitter, and Facebook image transforms

Changed

• Brought back the missing Transform Facebook OpenGraph Image field
• Don't do anything with pagination on console requests

Changed

• Make the base Container class extend FluentModel so that containers can be accessed via templates just like MetaTags are
• Ensure that we check to see if a container's include property is set before rendering it
• Use a unique cache key for everything for the request, including the pagination and URI
• Prep script containers for inclusion in includeScriptBodyHtml()

Changed

• Fixed a regression that caused an error loading entries

Changed

• Cleaned up how the pagination cache key works
• Add the current request path into the mix for the meta container cache key
• Force social media values to be displayed as strings

Changed

• Fixed an issue where SEOmatic wouldn't find Entry metadata if the entry was first saved as a Draft, then published
• Include the pagination page in the cache key to ensure paginated pages are uniquely cached

Changed

• Fixed a regression that caused you to be unable to save Custom URL for an image source in the Control Panel

Changed

• Fixed an issue where Content SEO permissions were not respected properly in the Control Panel
• Display the Tracking Scripts status in the Control Panel regardless of devMode setting

Added

• Don't render a canonical url for http status codes >= 400
• Set meta robots tag to none for http status codes >= 400

Security

• Decode HTML entities, then strip tags in safeCanonicalUrl()

Changed

• Really ensure that paginated pages are cached separately in the second-level cache

Changed

• No longer include any matched element in the Content SEO previews (which can be confusing if there are SEO Settings field overrides)
• Ensure that paginated pages are cached separately in the second-level cache
• Fixed an issue where changes to the SEO Image would not propagate to the Facebook/Twitter image when changed if "Same as SEO Image" was set

Security

• Changed the way requests that don't match any elements generate the canonicalUrl, to avoid potentially executing injected Twig code

Added

• Added Additional Sitemap URLs to Site Settings -> Miscellaneous for custom sitemap URLs
• Added EVENT_REGISTER_SITEMAP_URLS event so plugins can register custom sitemap URLs
• Added the Referrer-Policy header based on the value of the referrer tag
• Added the ability to control whether any http response headers are added by SEOmatic
• Added the Facebook OpenGraph tags og:image:width & og:image:height
• Added the Twitter card tags twitter:image:width & twitter:image:height

Changed

• Clear SEOmatic caches after saving the plugin settings
• Fixed an issue where boolean settings in meta containers that were set to false would not override as expected

Changed

• Fixed an issue with the language being set to en_US instead of en-US in getLocalizedUrls()

Changed

• Fix parsing logic error in MetaValue
• Fixed an issue where the SiteLinks Search Box wouldn't work because it errantly parsed the setting as Twig
• Better title for pull field dropdown menus
• Fix potential preview issues in Content SEO for certain multi-site setups

Added

• Added full support for Craft Commerce 2
• Added a caching layer to includeMetaContainers() for improved performance
• Added more fine-grained profiling data
• Re-organized how event handlers are loaded to allow for compatibility with Fallback Site plugin

Changed

• Canonical URLs are now always lower-cased, and made absolute
• Fixed an issue where the SiteLinks Search Box wouldn't work because it errantly parsed the setting as Twig
• Allow for default empty settings for the SEO Settings field for things like the Twitter Card type, etc.
• Added a warning to let people know tracking scripts are disabled when devMode is on
• Fixed an issue with JSON-LD dropping certain properties if non-default types were selected

Changed

• Strip tags from the incoming craft.app.request.pathInfo for the canonicalUrl
• Fixed the breadcrumbs link on the Plugin Settings page
• Fixed an issue where users without admin privileges could not save the SEOmatic Plugin Settings
• Fixed an issue where category groups would be lumped together in the sitemap
• Fixed an issue with og:locale and og:locale:alternate being improperly formatted

Added

• Allow the use of Emoji in the plugin settings, such as for the devMode title prefix

Changed

• Set the default devMode title prefix to 🚧
• Sync section / category group handles that are renamed
• Don't log meta item error messages unless devMode is on
• Don’t encode preview URLs
• Fixed an issue where disabling a section’s URLs was not sync properly with the Content SEO settings

Added

• Added support for emojis in any of the SEOmatic fields

Changed

• Fixed an issue introduced in Craft CMS 3.0.10 that would cause JSON-LD to be not fully rendered
• Allow nothing (--) to be selected as a Source Field in the Image/Video Sitemap fields
• Added cache busting to the SEO preview images so that they will always display the latest image
• Fixed an issue where removing an SEO Image from an SEO Settings field would cause it to persist

Changed

• Remove default value for devMode Prefix that prevented it from saving an empty value
• Fix default values for Title position, Twitter Title position, and OG Title position
• Allow for the setting of the dataLayer via Twig for Google Tag Manager
• Added pagination support via seomatic.helper.paginate() to properly set the paginated canonicalUrl as well as the <link rel='prev'> and <link rel='next'> tags
• Preserve the pagination trigger query string for the <link rel='hreflang'> tags

Changed

• Fixed ContactPoint rendering
• Fixed an issue where an array of one JSON-LD would not render
• Make JSON-LD URLs fully qualified

Changed

• Make sure twitter:creator and twitter:site are not resolve as aliases
• Fixed an issue where syncBundleWithConfig could return null
• Preserve the FrontendTemplate settings during meta bundle updates

Changed

• Ensure that the previews are not double-encoded
• Remove vestigial meta bundles from the sitemap index

Changed

• Fixed an issue where the JSON-LD types weren’t correct
• Sync bundle when Global SEO, Content SEO, and Site Settings are changed
• Ensure that the first character of each meta item key is lower-cased
• Render JSON-LD properties that have an @id set

Changed

• Make the various seomatic.helper functions more tolerant about having null passed in as a parameter

Changed

• Fixed a regression that the rel="alternate" link tags to not render properly
• Fixed a regression where the Site Settings would throw an exception

Changed

• Fixed a regression that caused per-environment settings to be applied in the Control Panel
• Fixed an issue that caused seomatic.xxx.get() to not return null if no matching item was found

Changed

• Ensure that any image or video URLs in the sitemap are full absolute URLs
• Fixed multiple issues with the gtag.js script that prevented it from working properly
• HTML-encode all URLs and user-enterable data in the sitemaps and sitemap indexes
• Fixed an issue where the meta items are not indexed properly, causing you to be unable to get them from the Twig API
• Fixed an issue where meta items that should have been excluded by environment were not

Changed

• Fixed an issue where the gtag body script did not properly render
• Fixed an issue where empty results for pull fields would not fall back on the parent (usually global) settings
• Fixed an issue where seomatic.helper.loadMetadataForUri() might not replace the container metadata properly

Changed

• Switch from .one() syntax to [0] to account for eager loading of transformed social media images
• Fixed an issue where SEOmatic incorrectly showed how many categories were in a category group on the Content SEO page
• Fixed an issue where Content SEO social images wouldn't fall back on the global images if they were set to "Same as SEO Image" and the SEO Image was empty
• Fixed a typo in the SEO Settings field settings
• SEOmatic no longer renders the rel="author" tag if you have humans.txt disabled

Added

• Added translations for the SEO Settings Field options

Changed

• Removed 'interlace' => 'line' from the social media transforms, which inexplicably caused Focal Points to not be used
• Fixed an issue where the JSON-LD would not fully render due to a regression

Changed

• Fixed incorrect social media permissions that prevented access to that settings page
• Fixed an issue where section meta bundles would be improperly marked as field due to a regression in the migration importing code
• Fixed an issue where categoryGroup meta bundles would be improperly marked as field due to a regression in the migration importing code
• Removed OpenGraph tag dependency on facebookProfileId or facebookAppId being present
• Fixed Pinterest verification tag dependency
• Bumped the schemaVersion

Added

• Added a migration to remove any errant seomatic_metabundles rows that have sourceBundleType set to field

Changed

• Fixed an issue when migrating data from Craft 2.x Seomatic_Meta fields and an Asset was set to "Custom"

Changed

• Removed excessive validation that was causing SEOmatic Fields to not save properly

Changed

• Fixed a regression that caused SEOmatic to not import data from old Craft 2.x Seomatic_Meta fields properly

Changed

• Fixed a regression that caused the Section meta bundles to be the wrong type

Changed

• Better instructions for the Canonical URL
• Updated translations
• Use correct sourceBundleType for Field meta bundles
• Fixed a regression that caused Content SEO sections to not save properly

Changed

• Don't display Sections / Category Groups in Content SEO that no longer have public URLs
• Fixed an issue with console requests
• Fixed an issue where Sections and Category groups with the same handle didn't work right in Content SEO
• More validation on the data passed into the SEO Settings field as a config array

Changed

• Fixed an issue where re-using the same Field handle from other Field types would cause an exception to be thrown in the Control Panel
• Improved the way SEOmatic matches the current element
• Bypass the data cache entirely in the Control Panel, to avoid refresh issues
• Fixed an issue where sometimes the correct data is not what is previewed in the Control Panel
• Fixed an issue where the canonicalUrl seemed immutable on the Global SEO pages

Added

• og:image tags are now validated to ensure they are fully qualified URLs
• og:image tags now are converted to absolute URLs (to handle protocol-less URLs)
• twitter:image tags are now validated to ensure they are fully qualified URLs
• twitter:image tags now are converted to absolute URLs (to handle protocol-less URLs)
• Added missing translations

Changed

• Fixed an issue where Tracking Scripts permissions weren't all propertly presented

Changed

• Fixed an issue with sitemap indexes for elements that have null URLs
• Fixed an issue with permissions and the Tracking Scripts page

Added

• Official GA release

Changed

• Fixed a regression that caused the Site switcher to no longer work in the SEOmatic settings
• Fixed a regression that could cause the sitemap index to include the appropriate sections

Changed

• Fixed an issue where the social transforms sometimes might not render properly
• SEOmatic now requires Craft CMS 3.0.2 or later (so we can listen to TemplateCaches::EVENT_AFTER_DELETE_CACHES)
• Handle Section or Category Groups that may have had their handles renamed

Added

• SEOmatic now clears its caches any time TemplateCaches::EVENT_AFTER_DELETE_CACHES is triggered
• If the FastcgiCacheBust plugins is installed, clear its caches when SEOmatic clears its own caches

Added

• Added performance profiling to major bottlenecks
• Lots of code cleanup courtesy of the PHP Inspections plugin

Changed

• Fixed an issue with the Field improperly saving values as objects
• Removed caching from Control Panel requests, which fixes improperly displayed social media previews
• Fixed a deprecation error with .iso8601()

Changed

Added

• Don't display the Facebook/Twitter not set in the sidebar preview, only on the Settings pages
• Added an Seomatic_Meta Field to more gracefully handle sites upgraded from Craft 2.x that used the old FieldType
• If you add an SEO Settings field to a Section that has an old Craft 2.x Seomatic Meta field in it, it will automatically migrate the data and settings to the new field for you
• SEOmatic will automatically map your old Craft 2.x Field settings to corresponding Content SEO settings

Changed

• Better Dashboard display of SEO setup graphs
• Fixed an issue with an improperly named Site / Social Media permission
• Fixed an issue with the helper functions not gracefully handling null being passed in
• Fixed validation errors that could cause you to be unable to save changes to various SEOmatic settings

Changed

• Added additional fields for the mainEntityOfPage JSON-LD
• Clicking on Settings on from the Control Panel now redirects to the appropriate SEOmatic sub-nav

Added

• Added an SEO Settings Field that allows you to override SEO settings on a per-entry basis
• Added a schema.org link for the Main Entity of Page type you have specified
• Added seomatic.helper.truncate and seomatic.helper.truncateOnWord helper functions for truncating text

Changed

• Fixed an issue where you could not disable humans.txt or robots.txt
• Fixed an issue where the computedType wasn't saved properly for Global and Content SEO
• Fixed an issue with JSON-LD generated for content containers not cascading as intended

Added

• Added the ability to globally disable sitemap rendering

Changed

• Preserve Site Identity and Site Creator settings across bundle updates

Changed

• Check against siteType, siteSubType and siteSpecificType being null on the Site Settings pages
• Updated humans.txt template to display information from the Creator settings
• Separate Identity and Creator Entity Brand fields
• Remove JSON-LD schema.org properties that have just one entry in them (just the @type)
• Fixed an issue where hreflangs could be incorrect

Added

• Documented the Identity and Creator Site Settings variables
• Added menu and acceptsReservations to the FoodEstablishment JSON-LD
• Added link rel=“home” to the default tag container
• Added seomatic.helper.getLocalizedUrls() function that will return a list of localized URLs
• Added sameAs social media URLs to the Identity JSON-LD
• Added og:locale:alternate Facebook OpenGraph tags

Changed

• Fixed an issue where fresh installations were not taken to the Welcome screen
• Replaced old SEOmatic icon in the Asset Bundle
• Fixed an issue where Identity and Creator settings were not properly defaulted from the config files on fresh installations
• Better parsing of the JSON-LD config files

Added

• Added Miscellaneous settings with Google Site Links search settings
• Preserve user settings in the Tracking Scripts when bundles are updated
• Fleshed out the JSON-LD for mainEntityOfPage, identity, and creator

Changed

• Separated the mainEntityOfPage templates off into a partial
• Cleaned up the Identity Settings & Creator Settings pages

Added

• Added a description of JSON-LD Structured Data to the Identity & Creator pages
• Added Main Entity of Page settings on the Global SEO and Content SEO General pages

Changed

• Fixed an issue with console requests raising an exception in addDynamicMetaToContainers()
• Add errors display to all settings templates

Added

• Implemented dynamic Identity Settings & Creator Settings pages

Changed

• Don't look for getPathInfo() during a console request
• Fixed an issue switching between sites on the Tracking scripts settings
• Revise how seoFileLink() works
• Handle eager loaded elements in TextHelper

Added

• Added colored status indicators on the Content SEO index page that match the colors in the donut chart on the Dashboard
• Added seomatic.helper.seoFileLink() to allow setting the X-Robots-Tag and Link headers on static files as per Advanced rel="canonical" HTTP Headers
• Added a Link header for the canonical URL

Changed

• Don't display SEO previews if the Section has no URLs

Changed

• Refactored the meta bundle update process to preserve user configured meta bundle settings
• Throw a 404 if a sitemap is hit but sitemaps have been disabled for that section
• Exclude section sitemaps from the sitemap index if sitemaps have been disabled for that section

Changed

• Reverted incorrect bundle merging

Added

• Added Schema helper class & controller in preparation for dynamic schema types displayed in the Control Panel

Changed

• Fixed incorrect moz-transform vendor prefix that caused the sidebar SEO preview to look weird in FireFox
• Fixed a nasty bug that could cause improper merging of config arrays, resulting in an ever-growing column size in the db

Changed

• Fixed per-environment rendering of attributes
• Made meta bundle updating non-destructive to existing data

Added

• Added a "Same as Global Site Name Position" setting as the default for the Site Name Position Content SEO settings

Changed

• Fixed an issue where the last breadcrumb on the Content SEO edit-content page was a 404
• Fixed a caching issue that could result in stale data if you used seomatic.helper.loadMetadataForUri()
• Don't automatically generate thumbnails for videos in the sitemap
• Changed the Dashboard charts over to gauge charts

Added

• Check whether the seomatic_metabundles table exists before installing any even listeners

Changed

• Fixed an issue where the caching didn't work properly for multi-sites

Added

• Added a validation rule for genericAddressCountry so it saves
• Added a validation rules for renderEnabled, separatorChar, displayAnalysisSidebar and displayPreviewSidebar so you can save the plugin settings.
• Added initial Dashboard

Changed

• Don't install event listeners until after all plugins have loaded, to ensure db migrations have been run

Added

• Added a migration for older Craft 2.x sites that had SEOmatic installed already, so that SEOmatic for Craft 3 can install its base tables

Changed

• Fixed an issue with an incorrect redirect destination after saving a Tracking Scripts setting in the Control Panel
• Optimized the images used in the documentation

Changed

• Fixed issues with : void on PHP 7.0.x

Added

• Initial beta release