The Hostinger Reach integration lets you add and update contacts in Hostinger Reach from forms created with WS Form. You can map form fields to Hostinger Reach contact fields, assign tags, set a subscription status, and optionally require users to opt in before their information is sent.

WS Form can also automatically create a form configured for Hostinger Reach from the Add Form page.

Installation

The Hostinger Reach add-on is installed in the same way as installing the WS Form PRO plugin.

Once installed, you will need to activate the license for the add-on. When you purchase the Hostinger Reach add-on, you will be given a license key. If you have lost your license key, click here.

To activate your license key:

1. Click WS Form in the WordPress administration menu.
2. Click Settings.
3. Click the Integrations tab.
4. Click Hostinger Reach.
5. Enter your license key in the Add-on License Key setting.
6. Click the Activate button.

If your license key fails to activate, ensure you are using the license key for the Hostinger Reach add-on and not your WS Form PRO license key.

Connecting To Hostinger Reach

To use the integration, WS Form needs a Hostinger API token and a Hostinger Reach profile.

To connect WS Form to Hostinger Reach:

1. Click WS Form in the WordPress administration menu.
2. Click Settings.
3. Click the Integrations tab.
4. Click Hostinger Reach.
5. Enter your Hostinger API token in the Hostinger API Token setting. If you do not have an API token, create one in Hostinger.
6. Choose the Hostinger Reach profile you want to use from the Hostinger Reach Profile setting.
7. Click Save.

If your Hostinger account only has one Reach profile, WS Form will automatically select it where possible.

The selected profile determines which contact fields and tags are available when configuring the Hostinger Reach action.

If you do not have a Hostinger account, you can create a new account here.

Creating A Form For Hostinger Reach

Automatically

WS Form can automatically create a form configured to add contacts to Hostinger Reach. The form includes the available Hostinger Reach contact fields, an opt-in checkbox, and a pre-configured Hostinger Reach action.

To create a Hostinger Reach form in WS Form:

1. Click WS Form in the WordPress administration menu.
2. Click Add New.
3. Select the Hostinger Reach tab at the top of the page.
4. Click Contact.
5. Wait a few moments while the form is created.

That’s it! Your form will be created and is ready to customize and add to your website.

The generated form includes standard Hostinger Reach contact fields such as email, name, surname, phone, and note. Custom contact fields configured in your selected Hostinger Reach profile can also be added to the form.

If you make changes to your contact fields in Hostinger Reach, use the refresh option when configuring field mapping to retrieve the latest fields.

Manually

You can use any form created in WS Form and add a Hostinger Reach action so that contact information is sent to Hostinger Reach when the form is saved or submitted.

To add a Hostinger Reach action:

1. When editing your form, click the Actions icon at the top of the page. The Actions sidebar will open on the right-hand side of the page.
2. Click the Add icon to add a new action.
3. Select Add to Hostinger Reach from the Action pulldown. The Hostinger Reach settings will appear.

As with all sidebars in WS Form, click the Save button at the bottom to save your changes, or click Cancel to disregard your changes.

The Hostinger Reach action settings are described below.

When Should This Action Run?

Choose when the Hostinger Reach action should run. The action can run when the form is saved, submitted, or both.

Opt-In Field

Use this setting if you want the Hostinger Reach action to run only when the user has opted in.

Select a Checkbox, Select, or Radio field from your form. A checkbox with a single unchecked choice is recommended for a typical email marketing opt-in.

If an Opt-In Field is selected and the user does not provide an opt-in value, the Hostinger Reach action will not run.

For consent-based email marketing, ensure your implementation meets the privacy and consent requirements that apply to your website and users. Learn more in our GDPR guide.

Status

Choose the subscription status to use for the contact.

Available options are:

• Subscribed
• Unsubscribed

The default setting is Subscribed.

Field Mapping

Field mapping tells WS Form which fields on your form correspond to fields in Hostinger Reach.

Hostinger Reach includes the following standard contact fields:

• Email
• Name
• Surname
• Phone
• Note

Custom contact fields configured in your selected Hostinger Reach profile are also available for field mapping.

The Email field must be mapped. WS Form uses the email address to identify the contact in Hostinger Reach. If the contact does not already exist, a new contact is created. If a contact with that email address already exists, the existing contact is updated.

To map a field:

1. Click the Add icon at the bottom right of the Field Mapping section.
2. In the left-hand column, select the WS Form field.
3. In the right-hand column, select the corresponding Hostinger Reach field.
4. Repeat this process for each field you want to send to Hostinger Reach.
5. Click the Save button at the bottom of the sidebar to save your changes.

WS Form will attempt to automatically map compatible fields where possible.

If you have added or changed custom fields in Hostinger Reach, click the refresh icon in the Field Mapping section to retrieve the latest fields.

Phone Numbers

Phone numbers sent to Hostinger Reach must use the E.164 international telephone number format. For example:

+14155552671

When WS Form automatically creates a Hostinger Reach form, the Phone field is configured to use and validate the E.164 format.

Tag Mapping

The Tag Mapping setting lets you dynamically assign Hostinger Reach tags according to values selected or entered on the form.

Use a Checkbox, Select, or Radio field for tag mapping.

The values associated with the field choices should contain either the Hostinger Reach tag UUID or the name of an existing Hostinger Reach tag.

Multiple values are supported, allowing more than one tag to be assigned to a contact.

This is useful when you want the tags assigned to a contact to depend on the choices they make on the form.

Tags

The Tags setting lets you assign one or more existing Hostinger Reach tags to every contact processed by this action.

Click the Add icon and choose a Hostinger Reach tag.

Repeat this process to assign additional tags.

If you have created or changed tags in Hostinger Reach, click the refresh icon to retrieve the latest tags.

You can use Tags and Tag Mapping together. Tags configured under Tags are always assigned, while Tag Mapping can assign additional tags according to values on the form.

Note

Enter an optional note to add to the Hostinger Reach contact.

You can use WS Form variables in this setting.

By default, the note is set to:

#blog_name: #form_label

Hostinger Reach notes have a maximum length of 75 characters. If the resulting note exceeds this length, WS Form will truncate it before sending it to Hostinger Reach.

If the Note contact field is mapped under Field Mapping, the mapped field value is used instead of the value entered in the Note setting.

Adding And Updating Contacts

The Hostinger Reach integration uses the mapped email address to determine whether a contact already exists.

If the email address does not exist in the selected Hostinger Reach profile, WS Form creates a new contact.

If the email address already exists, WS Form updates the existing contact with the mapped information.

This means the same Hostinger Reach action can be used for both new and existing contacts without requiring separate actions.

Tags configured by the action can also be assigned to the contact when the action runs.