How to Customise Your Workflow Parameters#

Using the flexible parameters, you can submit individual or multiple URLs, or even entire or partial sitemaps, to IndexNow on a regular basis. Find out how based on the following example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

name: Submit Sitemap URLs to IndexNow

on:
  schedule:
    - cron: 0 0 1 * *  # Run at midnight UTC on the 1st day of each month.

jobs:
  submit-sitemap:
    runs-on: ubuntu-latest
    steps:
      - name: Submit sitemap URLs to IndexNow
        uses: jakob-bagterp/index-now-submit-sitemap-urls-action@v1
        with:
          host: example.com
          api_key: ${{ secrets.INDEX_NOW_API_KEY }}
          api_key_location: https://example.com/${{ secrets.INDEX_NOW_API_KEY }}.txt
          endpoint: yandex
          urls: https://example.com
          sitemap_locations: https://example.com/sitemap.xml
          sitemap_filter: section1
          sitemap_days_ago: 2

Overview#

Parameters#

host#

Contains the domain (and subdomain) of your website. Required every time you submit any URLs or sitemaps to the IndexNow API.

For example, if the URL to your sitemap is https://example.com, then the host parameter should be example.com:

14

          host: example.com

Or if your website URL is https://www.example.com, then the host should be www.example.com:

14

          host: www.example.com

api_key#

The API key for IndexNow, e.g. a1b2c3d4. Required every time you submit any URLs or sitemaps to the IndexNow API.

You need to set an API key on your website to verify ownership of your domain. This should be kept secret and is required every time you submit a URL to the IndexNow API:

15

          api_key: ${{ secrets.INDEX_NOW_API_KEY }}

If you don't want to use the API key generator from Microsoft Bing, you can create your own API key.

api_key_location#

The location of the API key, e.g. https://example.com/a1b2c3d4.txt. Required every time you submit any URLs or sitemaps to the IndexNow API.

Similar to the api_key, the location of your API key should be kept secret:

16

          api_key_location: https://example.com/${{ secrets.INDEX_NOW_API_KEY }}.txt

endpoint#

Optional. The search engine endpoint, e.g. indexnow, bing, naver, seznam, yandex, yep. If not specified, Bing is used as the default endpoint.

17

          endpoint: yandex

urls#

Optional. The URL(s) to be submitted to IndexNow. Can be an individual URL, e.g. https://example.com:

18

          urls: https://example.com

Or multiple URLs as list:

18

          urls: https://example.com/page1 https://example.com/page2

Alternatively over multiple lines, if that's easier to read:

18
19
20

          urls: >
            https://example.com/page1
            https://example.com/page2

sitemap_locations#

Optional. The location of the sitemap(s) from which the URLs will be submitted to IndexNow. Can be an individual sitemap, e.g. https://example.com/sitemap.xml:

19

          sitemap_locations: https://example.com/sitemap.xml

Or multiple sitemaps as list:

19

          sitemap_locations: https://example.com/sitemap1.xml https://example.com/sitemap2.xml

Alternatively over multiple lines, if that's easier to read:

19
20
21

          sitemap_locations: >
            https://example.com/sitemap1.xml
            https://example.com/sitemap2.xml

sitemap_filter#

Optional. Only submit sitemap URLs that contain the filter string, e.g. section1. Optional.

20

          sitemap_filter: section1

Or filter the sitemap URLs for both section1 and section2 using a regular expression:

20

          sitemap_filter: "r'(section1)|(section2)'"

Alternatively, imagine that you want to prevent a whole section from being submitted. This can be achieved using a negative regular expression. This will match any URL that does not include the string /section1/:

20

          sitemap_filter: "r'^((?!/section1/).)*$'"

sitemap_days_ago#

Optional. Only submit sitemap URLs that have been modified recently based on the <lastmod> tag, e.g. 1, 2, or more days ago.

For example, all sitemap URLs that have been modified in the last week days will be submitted:

21

          sitemap_days_ago: 7

Or only submit sitemap URLs that have been modified since yesterday:

21

          sitemap_days_ago: 1

Or only submit sitemap URLs that have been modified today:

21

          sitemap_days_ago: 0