Skip to content

Getting started

Connecting and managing sites

On this page

In Searcio, a site is your shop or another website whose content Searcio searches. Each site has its own search index, its own keys, its own search settings and its own statistics. This page describes how to add a site and connect it to your shop, what a site's screen shows, and how to remove a site again.

Owners, managers and editors can add and remove sites, see Roles and permissions. The list of all sites is described in the Introduction.

Adding a site

A site gets into your team in one of two ways:

  • With the WordPress plugin. For a WordPress site or a WooCommerce shop this is the simplest way. The plugin creates the site itself when you connect, and it then appears in the list of sites. How this works is described in the WordPress plugin guide, in the chapter "Install and connect".
  • With the form in the dashboard. For every other case, such as a shop that talks to Searcio through the REST API, or if you prefer to enter the keys into the plugin yourself.

Adding a site with the form

  1. Click Sites in the sidebar, then Connect a site.
  2. Under Name, enter a name you will recognise the site by in the dashboard, such as "Northline Outdoor".
  3. Under URL, enter the full address including https://, such as https://www.northline-outdoor.co.uk.
  4. Choose the Platform: WordPress, WooCommerce, Magento, Shopify or Custom. The platform is shown next to the address in the dashboard. It does not change anything about the search.
  5. Click Connect.

The Connect a site form with name, URL and platform for a second shop, Northline Outlet

A domain can only be connected to Searcio once. Searcio compares the domain, not the exact address: https://www.northline-outdoor.co.uk and http://northline-outdoor.co.uk count as the same site. If the domain is already connected, the form says so. A site in the Trash releases its domain again.

Depending on your plan, you can connect a certain number of sites. When all of them are connected, the list shows a note with a link to a bigger plan instead of Connect a site.

If you added a WordPress site with the form, Connect to Searcio in the plugin no longer connects that domain. Enter the keys into the plugin by hand instead, as described under Connecting the site to your shop.

Keeping the keys safe

After you click Connect, Searcio opens the new site's Keys tab. The Write secret is highlighted there. It is shown this one time only and can no longer be retrieved once you reload the page. Copy it straight away and keep it somewhere safe, together with the Write key and the Search key.

What each key does, and what to do if the write secret is lost, is described under API keys.

Connecting the site to your shop

With the keys you connect your shop to the new site:

  • WordPress and WooCommerce: install the Searcio plugin and go to Searcio > Connection in the WordPress admin. Under Advanced: manual key entry, enter the Search key, the Write key and the Write secret, then click Save connection. The WordPress plugin guide describes these fields in the chapter "Install and connect".
  • Your own software and other platforms: your software sends the content to Searcio through the REST API with the write key and write secret, and the search box in your visitors' browser uses the search key. See the REST API reference.

First sync

A new site has the status Pending. As soon as your shop has sent its first content and Searcio has indexed it, the status changes to Connected. In the WordPress plugin, you start a sync for this on the Sync tab.

Every delivery of content appears in the site's sync history. The Documents column in the list of sites shows how many documents the site has in the index.

A site's screen

To open a site, click its name in the list of sites, or click Manage.

The header of the site Northline Outdoor with its status, address, platform and the four tabs

The top shows the site's name and status, with its address and platform underneath. Below that come the site's four tabs.

Site status

Status Meaning
Pending The site has been created, but Searcio has not indexed any content from it yet.
Connected Searcio has indexed content from the site, and search is ready.
Disabled The site is switched off. Searcio answers no searches for it and accepts no content. In this case, contact support.

The four tabs

Tab Contents Described under
Overview Search statistics, usage, report by email and sync history. The Overview tab
Search & relevance Fields & ranking, Synonyms, Result rules, Redirects, and Filters & languages. Also the Card templates and Quizzes buttons. Search settings, Result rules and redirects, Card templates, Product finder
AI AI search, AI image tags, AI photo search and the AI shopping assistant preview. AI features
Keys The site's API keys and removing the site. API keys

On a phone, the Search & relevance tab is shortened to Search.

Each tab has its own address. You can bookmark a tab or send its link to a team member.

The Overview tab

The Overview tab shows how search is doing on this site and whether its content is arriving. From top to bottom it contains:

  • Search statistics: what visitors searched for, which searches found nothing and which results were clicked. They depend on your plan and are described under Search statistics. If your plan does not include them, a note with Upgrade plan appears in their place.
  • This site's usage: what this site has used of your team's plan, with cards for searches, AI messages, AI image tags, visual searches and documents. Every request to the search counts here, including product listings, carousels and quiz results. That is why the number of searches is higher than in the statistics above.
  • Report by email: the site's key search figures in your inbox, regularly. See Email report and export.
  • Sync history: the latest deliveries of content, see below.

Sync history

The Sync history shows the last ten deliveries of content that your shop sent to Searcio. A large catalogue is sent in several deliveries and then takes up several rows.

The report by email and the sync history of Northline Outdoor, with completed syncs

Column Contents
Type Full sync for a delivery of the whole catalogue, Incremental for one that carries only what changed, as your shop reports it.
Status Pending, Running, Completed or Failed.
Documents How many documents were processed.
Started When the delivery began, such as "Today, 08:52" or "Yesterday, 17:30", in the same time zone as the search statistics.
Duration How long the processing took.

If the search index did not accept some documents of a delivery, the number of them appears under the status, with the reason below it. For a failed delivery, the error message appears there. When a delivery fails, the owner of the team also receives an email.

If the history is empty, it shows No syncs yet. Your shop has then not sent any content yet.

Removing a site

A removed site goes to the Trash first. From there you bring it back or delete it permanently.

Moving a site to the Trash

There are two ways:

  • In the list of sites: click Delete site in the site's row and confirm with Delete site.
  • On the Keys tab: in the Remove site section, click Move to Trash and confirm with Move to Trash.

While the site is in the Trash, Searcio answers no searches for it and accepts no content. Its search index is kept until you delete the site permanently. Its domain is released and can be connected again as a new site.

Restoring or deleting permanently

  1. Open Sites and choose Trash in the Active filter.
  2. In the site's row, click one of the actions:
    • Restore brings the site back with its index, its settings and its keys.
    • Delete permanently deletes the site and its search index. Confirm with Delete permanently.

A permanently deleted site cannot be restored.

Disconnect on the Connection tab of the WordPress plugin does not go through the Trash: it deletes the site and its search index in Searcio permanently, straight away.