Data layers & Intelligence

Get alerts when the registers change

8 min read
An alert is a standing search on one data layer. It tells your workspace when a record starts matching your conditions, when a field you watch changes, or when a record stops matching. Here you set one up, read what it finds, and watch individual companies. It takes about ten minutes.

Before you start

Alerts need a data layer switched on for your workspace (see Turn on a data layer). This guide uses Companies House; the fields you can choose depend on the layers you have switched on.

Anyone whose role includes Intelligence can see the Alerts tab. Setting up or deleting an alert, and watching a company, need a role with the Build permission for Intelligence. Ask an admin in Settings > Team & roles if you cannot.

Note

The companies, company numbers and changes in these pictures are examples made up for this guide. They are not real records.

Open the Alerts tab

Click Intelligence in the sidebar, then the Alerts tab. It has three parts: Your alerts, Watched companies and What changed.

The count beside the heading shows how many of your workspace’s 50 alerts and watch groups are in use. The line under it says how changes reach you.

The Intelligence page on its Alerts tab. The heading reads Alerts, In Beta, 0 of 50 used, with the line Changes are checked every 2 minutes. Your alerts says No alerts yet and has a New alert button; What changed says No changes yet, with Alert and What filters; Watched companies says No watched companies yet.

Name the alert and add its conditions

Click New alert. Give it a Name, choose the Data layer, and choose what to Find: Anything, Organisations or Premises.

Click Add criterion for each condition, up to 20. You are told about records that meet every one. At least one must narrow the alert, such as a place, a status or a date; the dialog says so if none does.

The example here finds newly registered companies: Company status is Active, and Incorporated within last (days) 7.

The top of the New alert dialog. Name is New registered companies, Data layer is Companies House and Find is Organisations. Under Conditions are two rows: Company status is Active, and Incorporated within last (days) 7 days, with an Add criterion button below.

Choose when you are told, and who

Under Tell me when, tick what counts as news:

  • A record starts matching: a new record meets your conditions, or one changes so that it does.
  • A watched field changes on a record that matches.
  • A record stops matching.

For new registered companies, tick A record starts matching only. Then choose Who is told: Everyone in the workspace, Only me or No one, and click Save alert.

The bottom of the New alert dialog. Under Tell me when, A record starts matching is ticked and A watched field changes and A record stops matching are not. Under Who is told, the choice is Everyone in the workspace, with the line Told in the app. A new alert starts quiet: nothing is sent for what already matches. Cancel and Save alert buttons sit at the foot.

Check that the alert is Live

The alert appears in Your alerts with its conditions in words. The chip beside its name says where it stands; hover over it for the reason:

  • Live: you are told as the registers publish.
  • Waiting: this kind of alert cannot be matched yet. It is kept, and starts by itself when it can.
  • Stopped: for example, the data layer it needs was switched off.
  • Gone: the alert is no longer held. Delete it and set it up again.

A new alert starts quiet. It tells you nothing about records that already match, only about what changes from now on.

The Alerts tab after saving. Your alerts lists New registered companies with a green Live chip and the summary Companies House, organisations. Company status is Active; Incorporated in the last 7 days. Tells you: started matching. Below it: 0 in last 24 h, Set up by Alex Morgan, a who is told choice of Everyone, a rename icon and a delete icon. A message at the foot reads Live: you will be told as the registers publish.

Avoid an alert that fires on everything

A watched field changes is ticked when the dialog opens. If you leave it ticked and choose no watched fields, any change to any matching record counts. An alert on Company status is Active alone would then tell you each time any active company files its accounts or changes an officer: hundreds of times a day. Its summary says Any change counts.

Either untick A watched field changes, as in the example above, or choose the fields you care about in the next step.

Watch only the fields that matter

When A watched field changes is ticked, a Watched fields box appears. Choose up to 30 fields. You are then told only when one of those changes.

This second example, Manufacturers in the West Midlands, tells you when a company starts matching or its Company status changes.

The Tell me when section of a New alert dialog with A record starts matching and A watched field changes ticked. Watched fields holds one choice, Company status, with the line Leave empty to be told of any change. Up to 30.

Change who is told, rename or delete an alert

Use the choice on an alert’s row to change who is told. It saves straight away.

To give an alert a clearer name, click the pencil icon on its row, type the new name and click Save. Only the name changes: the alert carries on, and what it has found stays listed under it.

You cannot change an alert’s conditions once it is saved. To change them, click the delete icon, confirm, and set up a new alert. A new one starts quiet again.

An alert row, New registered companies, Live, with its who is told choice open showing Everyone, Only me and No one, and a rename icon and a delete icon beside it.

Or start from a saved search

If you have already built the search you want in Profile Builder, open the Profile Builder tab, click the menu at the end of the saved search’s row and choose Set up an alert.

A saved search in Profile Builder, West Midlands toolmakers, with the criteria SIC codes contains 25730 and Region is West Midlands. Its menu is open, listing Open results, Rename, New search from this, Set up an alert and Delete.

Check the filled-in alert, then save it

The dialog opens with the search’s name, data layer and conditions filled in. An alert reads one data layer, so conditions on another layer are left out, and the dialog says so.

Check Tell me when and the Watched fields, as in steps 3 and 5, then click Save alert.

The New alert dialog filled in from the saved search: Name West Midlands toolmakers, Data layer Companies House, Find Anything, and the conditions SIC codes contains 25730 and Region is West Midlands. Tell me when has A record starts matching and A watched field changes ticked, Watched fields is empty, and Who is told is Everyone in the workspace.

Read What changed

What changed lists what your alerts and watched companies found, newest first. Changes are kept for 30 days. Each alert’s row also says how many changes it found in the last 24 hours.

The Alerts tab with three alerts, each Live, and 3 of 50 used. The first, Active companies in the West Midlands, carries the warning chip Too broad: 1,200 changes dropped, narrow it, and the summary ends Any change counts. What changed lists, newest first, a Too broad warning, then the changes of each alert with their date, alert name and a Started matching or Changed chip.

Read a change

Each change shows when it happened, which alert found it, and what happened:

  • The change in words, such as Company status: Active to Liquidation.
  • The company in your CRM it is about, as a link to its page. If you do not hold the company yet, you see its register reference and Add as a company instead.
  • A company brand new to the register shows New to the register: Atlas adds its details at its next build. Atlas is the service that supplies your data layers; the full record follows when it next updates.
  • Sources names where the data comes from. Click the information icon for the licence lines.
The What changed panel. A Too broad warning for Active companies in the West Midlands. A Started matching row for Companies House ZZ025602 with Add as a company and SIC codes: 25620, 25730. A Changed row for the company Thornhallow Engineering Ltd with Company status: Active to Liquidation. A Started matching row for Companies House ZZ025603 with New to the register: Atlas adds its details at its next build, Add as a company, and Company status: Active. Each change ends Sources: Companies House with an information icon.

If an alert is too broad

An alert that matches too much has some of its changes dropped. A warning row in What changed says how many, such as Too broad: 1,200 changes were dropped. Narrow the alert., and the alert’s row carries a Too broad chip (both are in the pictures above).

Delete the alert and set up a narrower one: add a condition, choose watched fields, or untick A watched field changes.

Filter the changes

Use Alert to see one alert’s changes, and What to see only Started matching, Changed or Stopped matching.

The Alert filter set to All alerts beside the What filter, open, listing Any change, Started matching, Changed and Stopped matching.

Open a record you do not hold yet

Click a register reference, such as Companies House ZZ025602. The record opens in a window over the tab, so your place in the list stays. Close the window to go back.

A window over the Alerts tab titled MERRICOTE TOOLING LIMITED, Organisation, Dudley, West Midlands, with the chips Active, Company number ZZ025602 and In 1 data layer, an Add as company button, and the Overview showing its address and its SIC codes 25620, 25730.

Add it as a company

Click Add as a company on the change, or Add as company in the record’s window. The Company name starts as the name on the register, which you can change. For a company new to the register that Atlas has not added yet, it starts empty: type the company’s name.

Choose the Initial tier and, if you like, a Pipeline and Stage, then click Save. The new company is linked to the register record.

The Add company dialog over the Alerts tab, with Company name MERRICOTE TOOLING LIMITED, Initial tier Watchlist or Portfolio, Pipeline, Stage, More details, and Cancel and Save buttons.

Get told in the app

Each time an alert finds something, the people it tells get one notification for that batch, such as New registered companies: 1 change. Click the bell at the top of the page and open the System tab to see them. Alerts send no email.

The Notifications panel on its System tab, with three unread notifications, each marked Alert: Manufacturers in the West Midlands: 2 changes, with Changed: Thornhallow Engineering Ltd. Company status: Active to Liquidation; New registered companies: 1 change with Started matching: Companies House ZZ025603. Company status: Active; and Active companies in the West Midlands with Too broad: 1,200 changes were dropped. Narrow the alert.

Open an alert's changes from its notification

Click a notification. The Alerts tab opens with What changed filtered to that alert, and the notification is marked as read.

The Alerts tab with the Alert filter set to Manufacturers in the West Midlands. What changed lists only its two changes: Companies House ZZ025602 started matching, and Thornhallow Engineering Ltd changed, Company status: Active to Liquidation.

Watch a company

To follow one company rather than a search, open the company and click Intelligence. The company must be linked to a register record (see Read a company’s Intelligence).

Recent changes lists what your alerts have found about this company. Click Watch this company to be told of any change to its register records.

The company page of Thornhallow Engineering Ltd on its Intelligence panel. The Connections card shows Companies House: Linked and a Watch this company button beside Network map. Below it, Recent changes lists Changed: Company status: Active to Liquidation, Sources: Companies House.

Confirm the cost

The confirmation says which register records are watched. Click Watch.

The Watch this company? confirmation: You will be told in the app when the register record linked to Thornhallow Engineering Ltd changes. until you stop watching. Cancel and Watch buttons.

Check that it is watched

The button becomes a Watching chip, with Stop watching beside it.

The same company page, where the Connections card now shows a green Watching chip with a Stop watching button beside it.

See your watched companies

Back on the Alerts tab, Watched companies lists each company with its status and its last change:

  • Active: watched; you are told when its register records change.
  • Paused: the data layers have paused the watch. It carries on by itself.
  • Not linked: the company has no register record to watch. Link one first.

Click Stop watching to stop. Watched companies are kept in groups, and each group counts as one of your workspace’s 50.

The Watched companies section of the Alerts tab: Thornhallow Engineering Ltd has a green Active chip, No changes yet, and a Stop watching button.