Back to Website
Product Documentation Commerce SEO

SEO

This document describes how SEO is generated and configured for your Kodaris website; including your products, categories, and content pages.

Before we get started, we’ll give a quick overview of the three different types of SEO we’ll cover in this document:

  1. Meta Fields
  2. OG Fields
  3. Structured Data

Meta Fields

Meta fields are used by search engines to drive search results on Google, Bing, etc. There are two main meta fields that you can configure to influence the search results for your products, categories, pages, etc

  1. Meta Title
    1. When a search result appears in the Google search results page, the meta title is used as the title link for the search result.
  2. Meta Description
    1. When a search result appears in the Google search results page, the meta description is used to give the search engine a summary about the page. Search engines will often use this as the description for the search result underneath the result title. Although they may use other content from the page instead if it better matches the user’s search terms.

Helpful Links: 
Documentation: https://developers.google.com/search/docs/fundamentals/seo-starter-guide

OG Fields

OG fields are used by third party platforms to display a page preview when a user shares a page from your website. For example, when a user shares a product page to a social media platform like Facebook or Twitter. There are six OG fields that can be set for your products, categories, pages…

  1. OG Type
    1. Specifies what type of content the page is. Usually you’ll want to use “website” unless otherwise indicated by the official OG documentation.
  2. OG Title
    1. Specifies the title that should be used for the preview
  3. OG Url
    1. The URL of your page on your website that the preview will link to.
  4. OG Image
    1. The image that will display in the preview
  5. OG Description
    1. A short description about the page which will display in the preview. 
  6. OG Locale
    1. Specifies the language locale of the content in your other OG tags
  1. Documentation: https://ogp.me/
  2. Validator: https://developers.facebook.com/tools/debug/

Structured Data

Structured data is a standardized format for providing information about a page and classifying the page content.  Adding structured data can enable rich search results that are more engaging to users and might encourage them to interact more with your website. 

Kodaris automatically generates structured data for your products, categories, and marketing/information pages; and includes required fields by default. There are many other optional fields that can also be included. Please refer to the official documentation if you’d like to find out more.

Helpful Links

  1. Documentation: https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data
  2. Product Documentation: https://developers.google.com/search/docs/appearance/structured-data/product#product-information
  3. Validator: https://validator.schema.org/
  4. Rich Results Tester: https://search.google.com/test/rich-results

Default SEO

Now that we’ve given a brief overview about the three types of SEO, let’s see how Kodaris generates SEO for your website and how you can customize it. The first thing we’ll cover is your default store SEO. In Kodaris you can configure default meta and OG fields which are displayed for your home page and any other pages/products/categories which have not yet been configured for SEO.  For example, if you’ve not added SEO to several of your products yet, the system will provide the default SEO fields instead until you configure the SEO for those products.

Set your default meta and OG fields:

  1. Login to the operations portal
  2. Navigate to Marketing > SEO
  3. You will see a list of meta fields and OG fields
  4. Update these to what you’d like to use on your website.

Video demonstration:

https://youtu.be/9GPeWteXhn4
https://youtu.be/GEbF8YrEZYw

Products

The next thing we’ll cover is SEO for your products. Kodaris automatically generates meta fields, og fields, and structured data for them. You can also customize the SEO for your products in your PIM.

Meta Fields

By default, Kodaris generates meta fields for your products based on your store SEO and your PIM data. You can also customize the meta fields per product.

Set meta fields for a product:

  1. Navigate to Operations > PIM > Products
  2. Select the product which you’d like to set the meta fields for
  3. Scroll down to the SEO section
  4. Provide the values you’d like to use in the provided meta field inputs
    1. Meta title - if no meta title is set, Kodaris uses your product name by default
    2. Meta description - if no meta description is set, Kodaris uses your global store meta description by default
  5. To verify your product meta fields are properly set:
    1. Navigate to your product on the website
    2. Right click
    3. Select View page source
    4. Locate the title and meta description tags
    5. They should be set to the values you provided in your PIM

Video demonstration:

https://youtu.be/mNFC-Df1foE

OG Fields

By default, Kodaris also generates OG fields for your products based on your store SEO and your PIM data. 

Generated fields:

  1. OG Type
    1. Set to your default store OG Type which is configured on the Marketing > SEO screen
  2. OG Title
    1. Set to your product SEO meta title
    2. If no meta title is configured on the product, Kodaris uses your product name instead
  3. OG Description
    1. Set to your product SEO meta description
    2. If no meta description is configured on the product, Kodaris uses your default store meta description instead
  4. OG Image
    1. Set to your product’s primary image
  5. OG Url
    1. Set to the url of the product on your website
  6. OG Locale
    1. Set to your default store OG Locale which is configured on the Marketing > SEO screen

Video demonstration:

https://youtu.be/X3nJQ63o-dg

Structured Data

Kodaris automatically generates structured data for your products and includes the required fields by default. There are many other optional fields that can be included. Please refer to the official documentation if you’d like to find out more.

Generated fields:

  1. Type
    1. Set to Product
    2. Tells Google this structured data snippet is describing a product listing
  2. Name
    1. Set to your product name
  3. Image
    1. Set to your product’s primary image
  4. Product ID
    1. Set to your product’s code/part #
  5. Url
    1. Set to the url of the product on your website
  6. Offers
    1. Lists your product’s public price

View the generated structured data for a product:

  1. Navigate to the product on your website
  2. Right click
  3. Choose Inspect Element
  4. Search on json
  5. You will see the structured data snippet for the product

Verify your product’s structured data:

  1. Copy your product’s url on your website
  2. Navigate to the structured data validator -> https://validator.schema.org/
  3. Enter the url in the provided input
  4. Choose Run Test
  5. You will see the structured data the validator found for the your product

Verify your product’s rich search results:

  1. Copy your product’s url on your website
  2. Navigate to the rich results tester -> https://search.google.com/test/rich-results
  3. Enter the url in the provided input
  4. Choose Test Url
  5. You will see the rich results test result for the product

Video Demonstration:

[coming soon]

Example

Kodaris generated the following structured data snippet for product: https://commerce.kodaris.com/product/AMERK4008

 <script type="application/ld+json">
        {
            "@context": "https://schema.org",
            "@type": "Product",
            "name": "3 in USG Donn Brand 15/16 in DX/DXL Acoustical Suspension System Tee Face Sleeve - TFS-1",
            "image": "https://s3.amazonaws.com/commerce.kodaris.com/product/9841_MD-USG_TFS_2.jpg",
            "description": "",
            "productID": "amerk4008",
            "url": "https://commerce.kodaris.com/product/amerk4008",
            "offers": {
                "@type": "Offer",
                "price": "38.57",
                "priceCurrency": "USD"
            }
        }
 </script>

Categories

Kodaris also generates meta fields, OG fields, and structured data for your product categories. You can configure and customize these fields in your Kodaris PIM much like you can for your products.

Meta Fields

The meta fields for your product categories are generated based on your store SEO and your PIM data. You can also customize the meta fields per category.

Set meta fields for a category:

  1. Navigate to Operations > PIM > Categories
  2. Select the category which you’d like to set the meta fields for
  3. Scroll down to the SEO section
  4. Provide the values you’d like to use in the provided meta field inputs
    1. Meta title - if no meta title is set, Kodaris uses your category name by default
    2. Meta description - if no meta description is set, Kodaris uses your global store meta description by default
  5. To verify your category meta fields are properly set:
    1. Navigate to your category on the website
    2. Right click
    3. Select View page source
    4. Locate the title and meta description tags
    5. They should be set to the values you provided in your PIM

Video demonstration:

https://youtu.be/naS2jQzs5ZY

OG Fields

By default, Kodaris generates OG fields for your categories based on your store SEO and your PIM data. 

Generated fields:

  1. OG Type
    1. Set to your default store OG Type which is configured on the Marketing > SEO screen
  2. OG Title
    1. Set to your category SEO meta title
    2. If no meta title is configured on the category, Kodaris uses your category name instead
  3. OG Description
    1. Set to your category SEO meta description
    2. If no meta description is configured on the category, Kodaris uses your default store meta description instead
  4. OG Image
    1. Set to your category’s primary image
  5. OG Url
    1. Set to the url of the category on your website
  6. OG Locale
    1. Set to your default store OG Locale which is configured on the Marketing > SEO screen

Video demonstration:

https://youtu.be/1Q0khP5NGeU

Structured Data

Kodaris automatically generates structured data for your product categories and includes the required fields by default. There are many other optional fields that can be included. Please refer to the official documentation if you’d like to find out more.

Google does not show rich search results for categories, however it will use the structured data to determine what you are offering on your category page.

Generated fields:

  1. Type
    1. Set to ItemList
    2. Tells Google this structured data snippet is describing a list of items
  2. Url
    1. Set to the url of your category on your website
  3. Number of Items
    1. Set to the number of products in your category
  4. Item List Element
    1. Contains the list of products shown on the category page
    2. Each item contains a valid Product structured data snippet. Please refer to the Products section in this document.

View the generated structured data for a category:

  1. Navigate to the category on your website
  2. Right click
  3. Choose Inspect Element
  4. Search on json
  5. You will see the structured data snippet for the category

Verify your category’s structured data:

  1. Copy your category’s url on your website
  2. Navigate to the structured data validator -> https://validator.schema.org/
  3. Enter the url in the provided input
  4. Choose Run Test
  5. You will see the structured data the validator found for the your category

Verify your category’s rich search results:

  1. Copy your category’s url on your website
  2. Navigate to the rich results tester -> https://search.google.com/test/rich-results
  3. Enter the url in the provided input
  4. Choose Test Url
  5. You will see the rich results test result for the category

Video Demonstration:

https://youtu.be/3AVw0cbRg8I

Example

Kodaris generated the following structured data for the Ceilings category. https://commerce.kodaris.com/category/ceilings

<script type="application/ld+json">
    {
        "@context": "http://schema.org",
        "@type": "ItemList",
        "url": "https://commerce.kodaris.com/category/ceilings",
        "numberOfItems": "225",
        "itemListElement": [
            
                {
                    "@type": "ListItem",
                    "position": 1,
                    "item": {
                        "@type": "Product",
                        "image": "https://s3.amazonaws.com/commerce.kodaris.com/product/9841_MD-USG_TFS_2.jpg",
                        "url": "/product/AMERK4008?categoryCode=ceilings",
                        "name": "3 in USG Donn Brand 15/16 in DX/DXL Acoustical Suspension System Tee Face Sleeve - TFS-1",
                        "offers": {
                            "@type": "Offer",
                            "price": 38.57,
                            "priceCurrency": "USD"
                        }
                    }
                },
    ...abreviated for brevity
}
</script>

Content Pages

Kodaris also generates meta fields, OG fields, and structured data for your marketing/informational pages. You can configure and customize the SEO in your Kodaris CMS.

Meta Fields

Kodaris generates meta fields for your content pages based on your store SEO and your CMS data. You can also customize the meta fields per page.

Set meta fields for a page:

  1. Navigate to Operations > CMS > Pages
  2. Select the page which you’d like to set the meta fields for
  3. Scroll down to the SEO section
  4. Provide the values you’d like to use in the provided meta field inputs
    1. Meta title - if no meta title is set, Kodaris uses your page name by default.
    2. Meta description - if no meta description is set, Kodaris uses your global store meta description by default
  5. To verify your page meta fields are properly set:
    1. Navigate to your page on the website
    2. Right click
    3. Select View page source
    4. Locate the title and meta description tags
    5. They should be set to the values you provided in your CMS

Video demonstration:

https://youtu.be/1JCU_ANaR5M

OG Fields

By default, Kodaris generates OG fields for your pages based on your store SEO and your CMS data. 

Generated fields:

  1. OG Type
    1. Set to your page OG type
    2. If no OG type is specified for the page, Kodaris uses your store OG type configured on the Marketing > SEO screen
  2. OG Title
    1. Set to your page OG title
    2. If no OG title is specified for the page, Kodaris uses your page meta title.
    3. If no meta title is set for the page, Kodaris uses your page name.
  3. OG Description
    1. Set to your page OG description
    2. If no OG description is specified for the page, Kodaris uses your page meta description.
    3. If no meta description is set for the page, Kodaris uses your default store OG description set in the Marketing > SEO screen.
  4. OG Image
    1. Set to your page’s OG image
    2. If no OG image is set for the page, Kodaris uses your page’s primary image
    3. If no primary image is set, Kodaris uses your default OG image set in the Marketing > SEO screen.
  5. OG Url
    1. Set to your page’s OG url
    2. If no OG url is set for the page, Kodaris uses the url of your page on your website
  6. OG Locale
    1. Set to your page’s OG locale
    2. If no OG locale is set for the page, Kodaris uses the default store OG locale set in the Marketing > SEO screen.

Set OG fields for a page:

  1. Navigate to Operations > CMS > Pages
  2. Select the page which you’d like to set the OG fields for
  3. Scroll down to the SEO section
  4. Provide the values you’d like to use in the provided OG field inputs
  5. To verify your page OG fields are properly set:
    1. Navigate to your page on the website
    2. Right click
    3. Select View page source
    4. Locate the OG tags
    5. They should be set to the values you provided in your CMS

Video demonstration:

https://youtu.be/dcuJaV7nI4Q

Structured Data

Kodaris automatically generates structured data for your content pages and includes the required fields by default. There are many other optional fields that can be included. Please refer to the official documentation if you’d like to find out more.

Generated fields:

  1. Type
    1. Set to Article
    2. Tells Google this structured data snippet is describing an article
  2. Headline
    1. Set to your page name
  3. Description
    1. Set to your page SEO description
    2. If no SEO description is set, Kodaris uses your page description
  4. Image
    1. Set to your page’s primary image
  5. Keywords
    1. Set to your page’s keywords
  6. Url
    1. Set to the url of the page on your website
  7. Date Created
    1. Set to the date your page was created in Kodaris
  8. Date Modified
    1. Set to the date your page was last edited in Kodaris
  9. Author
    1. Set to your organization

View the generated structured data for a page:

  1. Navigate to the page on your website
  2. Right click
  3. Choose Inspect Element
  4. Search on json
  5. You will see the structured data snippet for the page

Verify your page’s structured data:

  1. Copy your page’s url on your website
  2. Navigate to the structured data validator -> https://validator.schema.org/
  3. Enter the url in the provided input
  4. Choose Run Test
  5. You will see the structured data the validator found for the your page

Verify your page’s rich search results:

  1. Copy your page’s url on your website
  2. Navigate to the rich results tester -> https://search.google.com/test/rich-results
  3. Enter the url in the provided input
  4. Choose Test Url
  5. You will see the rich results test result for the page

Video Demonstration:

https://youtu.be/aiJxkDYE8r0

Example:

Kodaris generated the following structured data for the FAQs page.

<script type="application/ld+json">
    {
        "@context": "http://schema.org",
        "@type": "Article",
        "url": "https://commerce.kodaris.com/s/content/faqs",
        "author": [
            {
                "@type":"Organization",
                "name": "Kodaris",
                "url": "https://commerce.kodaris.com"
            }
        ],
        "image": "",
        "keywords": "",
        "headline": "Frequently Asked Questions",
        "description": "",
        "dateModified": "2024-02-05 17:44:58:196",
        "dateCreated": "2023-12-16 17:49:37"
    }
</script>

Sitemap

A sitemap is a file where you provide information about the pages, products, categories and other content on your site. Search engines read this file to crawl and index your site more efficiently.  You can also submit a sitemap directly to Google in the search console.

In Kodaris, you can view, generate and schedule a sitemap that includes all your products, product categories, and marketing/informational pages. 

  1. Generate your sitemap
    1. To manually generate your sitemap
      1. Navigate to Operations > Marketing > Seo
      2. Choose the Generate Sitemap button
      3. The system will generate your sitemap file and it will be available on your website at [yoursite]/sitemap.xml
  2. View your sitemap
    1. To view your current sitemap
      1. Navigate to [yoursite]/sitemap.xml
      2. Or, navigate to Operations > Marketing > Seo and choose View Sitemap
  3. Weekly sitemap generation
    1. Usually you want your sitemap to automatically re-generate at scheduled intervals. This ensures all your latest product, category, and marketing changes are reflected in the sitemap for search engines.
    2. To schedule your sitemap to update weekly
      1. Navigate to Operations > System > Settings
      2. Search for the jobGenerateSeoSiteMap setting and set the value to 1
      3. Click Save
      4. Kodaris will now automatically re-generate your sitemap every week

[image coming soon]

Helpful Links

  1. Documentation: https://www.sitemaps.org/protocol.html
  2. More Documentation: https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap#xml
  3. Video: [coming soon]

Example:

Sitemap Index:

Kodaris generates a top-level sitemap index file which lists the locations of 3 other sitemap files; for your products, categories, and marketing pages

<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <sitemap xmlns="">
    <loc>https://commerce.kodaris.com/sitemap_products_1.xml</loc>
  </sitemap>
  <sitemap xmlns="">
    <loc>https://commerce.kodaris.com/sitemap_categories_1.xml</loc>
  </sitemap>
  <sitemap xmlns="">
    <loc>https://commerce.kodaris.com/sitemap_content_pages_1.xml</loc>
  </sitemap>
</sitemapindex>

Product Sitemap: https://commerce.kodaris.com/sitemap_products_1.xml

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
  <url xmlns="">
    <loc>https://commerce.kodaris.com/product/093</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/product/1000GJ12-20</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/product/1000GJ14-12</loc>
    <lastmod>2024-04-29</lastmod>
</url>

... omitted for brevity

Category Sitemap: https://commerce.kodaris.com/sitemap_categories_1.xml

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
  <url xmlns="">
    <loc>https://commerce.kodaris.com/category/drywall</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/category/steel_light_gauge_stud</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/category/steel_light_gauge_track</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
... omitted for brevity

Page Sitemap: https://commerce.kodaris.com/sitemap_content_pages_1.xml

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
  <url xmlns="">
    <loc>https://commerce.kodaris.com/s/content/faqs</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/s/content/locations</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  <url xmlns="">
    <loc>https://commerce.kodaris.com/s/content/contact-us</loc>
    <lastmod>2024-04-29</lastmod>
  </url>
  ... omitted for brevity
In this article