SearchIQ

This page contains instructions on how to properly configure a SearchIQ and a NationBuilder site.

NationBuilder setup

#Page structure

For a page to appear in the sitemap - it must have a page status of "published", and it must either be included in the top nav or nested underneath a "pubblished" page that is included in the top nav. This is the only way we are able to crawl all the pages. Because of this - we recommend that all sites have an "Other (folder)" page - where random / miscellaneous pages can be kept, hidden from the nav, but still indexable.

An example of what top level pages on your site might look like:

• Home
• About (folder)
• News
• Resources
• Donate
• Other (folder)

These pages would all have the "Include in top nav" page setting checked. The "Other (folder)" would likely have a page tag (nav_hide or something) to prevent it being added to the UI.

Sitemap and XML pages

Underneath your "Other (folder)" page - you should create 2 published basic pages:

• sitemap
• sitemap_xml

Once these pages have been created you can view the live page - and if the site is based off our Public Theme or another site that has search already - you shouldn't have to do anything else. If these are not automatically displaying the sitemap (current site page structure) - a developer may need to copy across page templates _z_page_sitemap.html and _z_page_sitemap_xml.html and wire them into layout.html based on page slug.

You should add page_no_robots tag to these - as we don't want them to appear in our search results.

Sitemap page

Once configured - this page will create a "tree" of pages - a sitemap - that we will feed to SearchIQ as the sitewide search dataset.

A page will be visible here if:

• it has a page status of "published"
• it is a top-level page
• it is nested underneath a "published" top-level page
• it is nested under a "published" page, which is nested under a "published" top level page (and so on)

If the page is visible as a link - it is indexable and will be searchable.

If the page is visible as plain text - it is "published" and part of the sitemap tree structure - but is NOT searchable. This is either done intentionally by adding the page_no_robots tag to the page or by developer logic (for example: hiding all profiles, or hiding a specific blog's blog posts).

If you are not seeing a page that you would expect to see in the structure - check it's ancestors in NationBuilder - likely something isn't set to "published".

Sitemap XML page

This is the page URL that we will feed to SearchIQ. It contains all the URLs from the "link" pages on the Sitemap page.

SearchIQ setup

It is best to set up SearchIQ on your site after it has already gone live. There are two main reasons for this:

1. Your NationBuilder site needs to be "open":
   NB site > Site Settings > "Allow search engines" checked.
   NB site > Site Settings > Who can view this site? "Anyone".
2. You cannot change the URL of a SearchIQ instance.
   So if you set it up when the site is still a NationBuilder subdomain - you will need to add a new instance once the site goes live at its production domain.

Log into SearchIQ with the contact@forpurpose account and click the + Add another button at the bottom of the "Overview" page.
Is your site built on WordPress? Click the No, it's something else button.
Paste in the URL of your site and click the Add Site button.