Skip to content
Configure the Knowledge Management Service Portal › Configuring Knowledge Management › Knowledge Management › Manage content capabilities › Extend ServiceNow AI Platform capabilities
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure custom SEO tags for canonical URLs and localized knowledge articles

Discover relevant knowledge articles through search engines by adding custom SEO tags for canonical URLs and hreflang tags to the knowledge article view page.

Before you begin

Role required: admin

About this task

Update the SPSEOHeaderTagsArticleView script include to add canonical URLs andhreflang tags to the knowledge article view page. You can also add custom header tags to the knowledge article view page by implementing the generateCustomTagsForSEO function.

Note: The metatags will be added to the Knowledge Article View [kb_article_view] only when viewed by the user agents mentioned in glide.knowman.serviceportal.seo_user_agent system property. For more information, see Create and edit a page using the Service Portal Designer.

For information about the default behavior of canonical URLs and hreflang tags for the knowledge article view page, see SEO for canonical URLs and localized versions of knowledge articles.

Procedure

  1. Navigate to All > System Definitions > Script Includes.

  2. Search for SPSEOHeaderTagsArticleView.

  3. In the Name column, click the SPSEOHeaderTagsArticleView link.

  4. On the Script Include form, modify the functions for knowledge articles.

For more information about configuring script includes, see [Script includes](../../api-reference/scripts/c_ScriptIncludes.md).
  1. Click Update.

Parent Topic:Configure the Knowledge Management Service Portal

sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow.

ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

© 2026 ServiceNow, Inc. All rights reserved.

Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.

FunctionalityImplementation
Return a canonical URL for a knowledge articleModify the generateCanonicalURL function to return the fully qualified canonical URL of a knowledge article as a string.For example, use the following URL format for a knowledge article in the customer service portal: `"https://.servicenow-com/csp?id=kb_article_view&sysparm_article=
"`
Return an hreflang tag for translated versions of a knowledge articleModify the generateHrefLangArray function to return an hreflang array for the current language and the available translations for a knowledge article.For example, use the following format for a knowledge article translated in French in the customer service portal: [{locale:'fr', href: 'https://<instance name>.servicenow-com/csp?id=kb_article_view&sysparm_article=<article number>'}]
Return a custom header for a knowledge articleModify the generateCustomTagsForSEO function to return any custom header tags as an array of strings used for the knowledge article view page. For example, use the following format for a custom tag for a knowledge article: `['']`
Return a SEO optimized HTML content for SEO botsModify the generateSEOTags function to return the SEO optimized HTML content in items.customSEOHTML.