Q: Which version of the package do I have?

Go to Setup → Installed Packages and look for Data8 Data Enhancement App. The version number is shown next to it. See our release notes for what changed in each version.

Q: I can't see Data8 in the App Launcher or the components in Lightning App Builder.

Check that the installation has finished (Setup → Installed Packages) and that your user has been assigned the Data8 User permission set. Without the permission set, the Data8 Configuration app and components aren’t visible.

Q: Do the components create the fields they need?

No. Every field you enter in a component’s settings, including Validation Result and Last Validated fields, must already exist on the object. Create the fields first, then add the component and enter their API names. Remember that custom fields end in __c. The User Guide lists the fields for each component.

Q: The component appears on the page, but nothing is saved or populated.

This is usually because a field doesn’t exist, its API name was entered incorrectly (often missing __c), or the user doesn’t have Read and Edit access to the field. Check the field in Object Manager and the user’s profile or permission sets.

Question 1

Where can I use the Data8 components?

Accepted Answer

The Data8 Data Validation package is installed from Salesforce AppExchange and its components are built for Lightning Experience. They can be added to Lightning record pages and to Screen Flows.

Question 2

Which version of the package do I have?

Accepted Answer

Go to Setup &rarr; Installed Packages and look for Data8 Data Enhancement App. The version number is shown next to it. See our release notes for what changed in each version.

Question 3

Where do I get my API keys, and which one goes where?

Accepted Answer

You can create API keys on the Data8 dashboard. In Salesforce, open Data8 Configuration → Settings, click Edit API Keys and enter both keys:

Client-Side API Key: used by the on-screen components.
Server-Side API Key: used by server-side processes and flows.

A common cause of errors is pasting a key into the wrong box.

Question 4

I can't see Data8 in the App Launcher or the components in Lightning App Builder.

Accepted Answer

Check that the installation has finished (Setup &rarr; Installed Packages) and that your user has been assigned the Data8 User permission set. Without the permission set, the Data8 Configuration app and components aren&#8217;t visible.

Question 5

Do the components create the fields they need?

Accepted Answer

No. Every field you enter in a component&#8217;s settings, including Validation Result and Last Validated fields, must already exist on the object. Create the fields first, then add the component and enter their API names. Remember that custom fields end in __c. The User Guide lists the fields for each component.

Question 6

The component appears on the page, but nothing is saved or populated.

Accepted Answer

This is usually because a field doesn&#8217;t exist, its API name was entered incorrectly (often missing __c), or the user doesn&#8217;t have Read and Edit access to the field. Check the field in Object Manager and the user&#8217;s profile or permission sets.

Question 7

I see an "Unable to reach Data8 service" message.

Accepted Answer

The package includes a Remote Site Setting and a CSP Trusted Site for https://webservices.data-8.co.uk, both named Data8. Make sure both are present and active under Setup &rarr; Remote Site Settings and Setup &rarr; CSP Trusted Sites.

Question 8

A component loads but never returns a result.

Accepted Answer

The service may not be enabled on your Data8 subscription, you may have run out of credits, or the check may be turned off in the component (for example Enable Validation or Enable TPS Screening). A &#8220;This service is unavailable&#8221; (HTTP 403) message usually means the API key is wrong or the service isn&#8217;t on your subscription. Your credit balance for each service is shown on the Settings page.

Question 9

I was using the Data8 Field Validation component. What should I do?

Accepted Answer

From version 2.0, Field Validation has been replaced by the separate Data8 Email Validation and Data8 Phone Validation components. The old component is still installed as Data8 Field Validation (Deprecated) so existing pages keep working, but we recommend replacing it with the new components when you can.

Question 10

Why does PredictiveAddress show a configuration error?

Accepted Answer

Either both UDPRN and UPRN fields are mapped (Data8 returns only one property reference per address, so map one or the other), or an Organisation field is mapped while organisation handling is set to &#8220;Ignore it&#8221;.

Question 11

An address was changed elsewhere but still shows as Valid.

Accepted Answer

Map the optional Checked Address field on the PredictiveAddress component. It stores a fingerprint of the confirmed address, so the component can detect changes made outside it (for example by a Data Loader import) and reset the validation status.

Question 12

Why won't a record save with a manually typed address?

Accepted Answer

Block Saving Unvalidated Addresses is turned on in Data8 Configuration &rarr; Settings. With this option on, an address must be confirmed by a PredictiveAddress lookup before the record can be saved.

Question 13

Can I use the Data8 components in a Screen Flow?

Accepted Answer

Yes. Email Validation, Phone Validation, PredictiveAddress and Bank Account Validation can all be added to a Screen Flow screen. The components don&#8217;t save to the record themselves in a flow, so add an Update Records or Create Records element after the screen. See Using the components in a Screen Flow.

Question 14

How do I refresh Business Insights company data?

Accepted Answer

Add the Data8 Business Insights Refresh quick action to the record page or Company page and run it, or tick Refresh Now on the Company record.

Salesforce Frequently Asked Questions

Frequently Asked Questions