> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: SEO Best Practices

## Article: SEO Best Practices

## Article Link: https://dev.wix.com/docs/develop-websites-sdk/code-your-site/best-practices/seo-best-practices.md

## Article Content:

# SEO Best Practices

Here are some tips for improving a site's visibility in search engines and avoiding SEO pitfalls.

## Make sure search engines can crawl your content

One of the first steps to ensure effective SEO is making sure search engines can crawl and index your site content. Some of your site content may be dynamic. How can you make sure that search bots can view your content?

### Search bots like HTML

Wix sites are built using editor components that are rendered into HTML. You can also customize the content and layout of your site by adding code using [the Wix JavaScript SDK](https://dev.wix.com/docs/sdk/articles/get-started/about-the-wix-java-script-sdk.md).

Search bots access your page content by sending an HTTP request to your page and reading the HTML content generated from the initial page rendering. At a later date, some search bots also render the page themselves and run any JavaScript code. Since not all search bots run JavaScript code, you should make sure the code returning the content you want to be indexed runs before your page is initially rendered. Content not included in the initial HTML output may be indexed after a long delay, indexed incorrectly, or not at all.

For this reason, and also to increase the performance of your site, Wix uses server-side rendering (SSR) to render your page's components on the server and return them to the browser as HTML. How can you make sure your content is included in the SSR version of your page?

### Inside the onReady() function

Anything that occurs in the [`onReady()`](https://dev.wix.com/docs/velo/velo-only-apis/$w/on-ready.md) function is rendered on the server, returned as HTML, and seen by search engines.

For most use cases, it's enough to just call the function in `onReady()`. For asynchronous functions and functions that run following a delay, the `onReady()` promise may resolve before the function's promise has a chance to resolve. In such cases, if you need the returned content to be indexed, you can block the `onReady()` from resolving until your function's promise resolves. You can indicate to the server that it should wait by returning the promise in `onReady()`.

For example, let's say you have a repeater on your page that's populated with data queried from a database collection:

```javascript
import { items } from '@wix/data';

$w.onReady(function () {
    $w("#myRepeater").onItemReady(($item, itemData, index) => {
         $item("#text").text = itemData.title;
         $item("#image").src = itemData.image;
    });
    
    items.query("MyCollection")
        .find()
        .then((results) => {
            $w('#myRepeater').data = results.items;
        });
});
```

In this example, the asynchronous query's promise may not resolve before the `onReady()` promise resolves, and the SSR version of your page may not include the queried repeater content. To ensure that the query resolves before `onReady()`, we can return the query in `onReady()`. See the change to Line 10:

```javascript
import { items } from '@wix/data';

$w.onReady(function () {
    $w("#myRepeater").onItemReady(($item, itemData, index) => {
         $item("#text").text = itemData.title;
         $item("#image").src = itemData.image;
    });
    
    return items.query("MyCollection")
        .find()
        .then((results) => {
            $w('#myRepeater').data = results.items;
        });
});
```

Note that returning a promise in the `onReady()` function may affect the [performance](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/best-practices/data/data-retrieval-performance-boosts.md) of your site, as all the data will load before the page is rendered. Since there is a tradeoff between SEO and performance, you might want to wait for the main content that's important for indexing, and let auxiliary content such as the time or weather information load later.

>**Note:** 
> Database content that's loaded into page elements using a dataset (instead of code) is included in the SSR version of your page and will be seen by search engines.

### Test your site

You can emulate a search bot to test your site's content by setting your browser's user agent to a specific bot. For example, you can emulate a Google bot and check which site content Google bots will initially crawl.

<details>
<summary>Show me how</summary>

  
To emulate a Google bot in the Google Chrome browser:

1.  Navigate to your published site.
2.  Open [Developer Tools](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_are_browser_developer_tools). 
3.  Click the 3-dots menu at the top right.
4.  Select **More tools** \> **Network conditions**.  

![Developer Tools Network Conditions](https://wixmp-833713b177cebf373f611808.wixmp.com/images/f21c62e92c179fed7ae740ca51ab39e3.png) 
    
5.  In the User Agent section, clear the **Select automatically** checkbox.
6.  Select **Googlebot**.  
    
![Developer Tools User Agent selection](https://wixmp-833713b177cebf373f611808.wixmp.com/images/df19544bd249fce327830465e9071fd8.png)
    
7.  Reload your site.  
    Now you're viewing the page content Google bots will initially crawl and index.

</details>

## Links and SEO

Search engines learn a lot about your site from internal site links. Since internal links impact your site's SEO, it's important to know how to set up and manage links on your site.

### Crawlable links

Google bots only crawl links with an HTML `<a>` tag with an `href` attribute. There are several ways to add crawlable `href` links to your Wix site:

*   Add a site menu to your site ([Wix Studio](https://support.wix.com/en/article/studio-editor-adding-and-managing-menus) | [Wix Editor](https://support.wix.com/en/article/adding-a-site-menu)).
*   Add a hyperlink to your text ([Wix Studio](https://support.wix.com/en/article/studio-editor-adding-and-customizing-text) | [Wix Editor](https://support.wix.com/en/article/wix-editor-adding-a-link-to-text)).
*   Use the link button to add a link to a clickable element such as a button or image.
*   Use a dataset to [connect URLs](https://support.wix.com/en/article/connecting-a-button-to-a-database-collection) from a database collection to clickable elements such as a buttons or images.

Other methods of adding links to your site aren't guaranteed to generate `href` links. You can add non-crawlable links to your site, but you should make sure that every page of your site is reachable from at least 1 crawlable link.

### Use page query parameters for pagination

There are different ways to handle loading more page content when the content is too long to fit on a single page. One method is to use a numbered menu that loads a specific number of items for each numbered button that's clicked.

If you are using a numbered menu for pagination and you want search engines to crawl and index each batch of content as an independent page, add a page query parameter to the link for each numbered button: `?page=<pageNumber>`. Google views URLs with numbered page query parameters as links to independent pages.

For example, let's say you have a numbered menu with several buttons:

<div style="text-align:center">

 ![Numbered paging](https://wixmp-833713b177cebf373f611808.wixmp.com/images/1566600a5a336d0b9de870e0546bc096.png) 

</div>

Google indexes the following as 2 separate pages:

*   `#button2` URL: `https://www.example.com?page=2`
*   `#button3` URL: `https://www.example.com?page=3`

>**Note:** 
> For the link to the first page, don't set the query param to **?page=1** since you'll have 2 URLs pointing to the same page. Instead you can link to the main page.

### Does URL case matter?

Google treats URLs as case sensitive. For example, Google views each of these URLs as unique:

*   `www.mysite.com/page.html`
*   `www.mysite.com/PAGE.html`

Google recommends exposing either the uppercase or lowercase version of a URL, and not both. Even if you've set both URLs to point to the same page so that a site visitor reaches the same destination regardless, you may not want both versions out there on the web pointing to your page.  

When multiple URLs point to the same page, Google chooses only one to represent the content on your page, and highlights only that URL in search results. And it might not be the URL you prefer.

So which case should you choose, uppercase or lowercase? Lowercase is recommended, since it's more common and you can assume that at least some people will use the lowercase URL to link to your site.

## Images and SEO

Site images play a significant role in determining your site's SEO. But how do search engines "read" your images? They check the image's alternative text (alt text), a short but meaningful description you can assign to your image.

You can [add alt text](https://support.wix.com/en/article/studio-editor-adding-alt-text-to-images) to an image using the editor, but if you are displaying multiple images from a database collection, you can dynamically assign alternate text to your images with code using the [`alt`](https://dev.wix.com/docs/velo/velo-only-apis/$w/image/alt.md) image property, or by connecting to alternative text stored in a database collection using a dataset.

![Dynamic alt text](https://wixmp-833713b177cebf373f611808.wixmp.com/images/783977178be45a74dfb1a83ad7c2db34.png)

## Dynamic pages and routers

[Dynamic pages](https://support.wix.com/en/article/cms-about-dynamic-pages) and [router pages](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/build-a-custom-backend/routers/about-routers.md) are different than regular pages in that they contain dynamic data. SEO information for a dynamic or router page must be set dynamically, so that it reflects the real content the pages hold when they're viewed.

You can [define SEO information](https://support.wix.com/en/article/working-with-seo-settings-for-dynamic-pages) for your dynamic pages in the editor.

You can dynamically [define the following SEO information](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/build-a-custom-backend/routers/add-seo-to-your-router.md) for your router pages:

*   [Meta tags](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/build-a-custom-backend/routers/add-seo-to-your-router.md#step-1--set-meta-tags-for-router-pages): Help search engines learn about your pages.
*   [Sitemap](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/build-a-custom-backend/routers/add-seo-to-your-router.md#step-2--create-the-sitemap-for-your-router): Help search engines find your pages.

## Build a great site structure

Site structure refers to how you organize content on your site. For example, how do pages with your main content link to pages with subtopics? How many pages will a site visitor have to navigate to reach the content they want? Is the connection between pages with related content organized or random?

Planning and mapping out an organized site structure will make it easier for search engines to crawl and index your site. Google awards [sitelinks](https://developers.google.com/search/docs/appearance/sitelinks?hl=en&visit_id=638694267737097538-2339297366&rd=1), additional links that appear beneath the main URL in a Google search, to sites with great site structures.

Use [database collections](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/work-with-data/introduction/about-collections.md) and [dynamic pages](https://support.wix.com/en/article/creating-unlimited-site-pages-with-a-dynamic-page) to improve and organize your site structure. Consider the following factors when planning your site:

*   **Organized hierarchy:** Make sure the connection between pages on your site isn't random. Your site hierarchy should be organized and fairly shallow (not too many levels). 
    
    This is easy to accomplish using dynamic pages, where you can automatically generate multiple pages with similar structure and different content all relating to a main index page. 
    
*   **URL structure:** The structure of your URLs should mirror your navigation hierarchy. Each level of your site should be represented by a section of your URL containing an appropriate keyword. For example, if you've got a recipe site divided by cuisine type and then by course, a site visitor who selects Italian cuisine and then appetizer recipes should see a URL that reflects the site hierarchy:
    
     ![URL hierarchy](https://wixmp-833713b177cebf373f611808.wixmp.com/images/444af8576102fe50d28f2cd0f9e43fc4.png) 
    
    You can automatically generate [structured URLs](https://support.wix.com/en/article/customizing-your-pages-url-structure-in-seo-settings) for your pages using dynamic list and item pages.
    
*   **Internal links:** Search engines use internal links to crawl the pages of your site. In general, the more internal links the better, but minimally every page on your website should have a link to and from another page on your site.
    
    You can create an index page or a dynamic list page to easily link to and from dynamic item pages on your site.

>**Note:** 
> [SEO settings](https://support.wix.com/en/article/working-with-seo-settings-for-dynamic-pages) for dynamic pages are different than SEO settings for regular site pages.

## Set SEO data with the SEO API

You can use the [SEO API](https://dev.wix.com/docs/sdk/frontend-modules/seo/introduction.md) to get and set SEO information for your site pages:

*   **Title tag:** Gets and sets the clickable heading that appears in search result pages.
*   **Link tags:** Gets and sets link relation attributes for multiple URLs that point to your page. For example, `rel canonical` lets search engines know which URL represents the master copy of your page.
*   **Meta tags:** Gets and sets metadata, additional information about your page. For example, you could use meta tags to control what content appears when your page is shared on Facebook, or to prevent search engines from indexing your page.
*   **Structured data markup:** Gets and sets additional information about your page in a standardized format that can be read by search engines. Search engines use this information to classify your page content and possibly display the search result for your page as [rich results](https://yoast.com/what-are-rich-snippets/) (snippets). For example, you can use structured data to let search engines know your page content is a recipe or contact information for an organization.

>**Note:** 
> To ensure the SEO data you set will be read by search engines, make sure to set such data in the [`onReady()`](https://dev.wix.com/docs/velo/velo-only-apis/$w/on-ready.md) event handler.

## Track site events

You can connect a 3rd-party [marketing tool](https://support.wix.com/en/article/about-marketing-integrations) such as Google Analytics or Facebook Pixel to your Wix site and collect valuable information about your visitors' behavior. Wix helps you track specific visitor events such as page views and purchases and report them to your integrated marketing tool. You can then use this information to optimize your site.

If you want to track additional visitor actions not included in the default tracking events available using Wix marketing integrations, you can use the [Track Event API](https://dev.wix.com/docs/sdk/frontend-modules/window/track-event.md). For example, you can [add tracking code](https://dev.wix.com/docs/develop-websites-sdk/code-your-site/build-a-custom-frontend/event-handlers/add-an-event-handler.md) to a download button and report to a 3rd-party tool every time a visitor downloads a document. 

## See also

*   [Wix SEO Setup Checklist](https://support.wix.com/en/article/improving-your-online-presence-with-the-wix-seo-setup-checklist): A step-by-step plan designed to help you improve your site's SEO. 
*   [Wix SEO Guide](https://www.wix.com/seo/learn/wix-seo-guide): Everything you need to know to set up your website's SEO and get found online.
*   [Google SEO Guidelines](https://developers.google.com/search/docs/guides/get-started): Don't forget to carefully check Google's SEO guidelines. If you are experiencing SEO issues with your site, it's worthwhile to review Google's guidelines again and make sure you aren't inadvertently missing any important details.