Forum


TF Import 2.5.9 Pro

Trevor Bourne
2%
Posts: 2
  • TF Import
October 07, 2026

TF Import Pro 2.5.9 — Joomla 6.1.4 — Joomla Contacts CSV import fails

I am importing contacts using Dashboard → Import → Joomla Contacts.

The import fails with:
COM_CONTACT_WARNING_PROVIDE_VALID_NAME

I exported an existing Joomla Contact using TF Import's own Export function and used that exported CSV structure as the template for the import. The CSV contains name, con_position, address, suburb, state, country, postcode, telephone, fax, email_to, published, catid, mobile, and webpage.
name contains a valid value and catid contains the valid Contact category ID, but the import still reports that a valid name has not been provided.

Joomla reports no extension updates available.

Is there a known issue with Joomla Contacts CSV import in TF Import 2.5.9 / Joomla 6.1.4, or is another CSV field required?

Joomla Fry
100%
Posts: 1118
October 08, 2026

Hello

Import should work with only name, catid and published in the CSV file.

Please check if CSV file is separated by comma (,). Other separators will not work.

If this doesn't work, please share sample of CSV file or admin credentials at mail@joomlafry.com. Need to check this further.

Thank you

Trevor Bourne
2%
Posts: 2
October 09, 2026

Thank you for your reply. We've made some progress, but have identified further problems with importing Joomla Contacts.

Environment: Joomla 6.1.4, TF Import Pro 2.5.9.

We successfully imported a contact using only name, catid, and published, as you suggested.

We then successfully updated that contact using its existing Joomla ID and the fields con_position, telephone, and email_to.

Adding address and suburb also worked.

However, when we attempted to import additional standard contact fields, including state, postcode, and fax, the import failed with:

COM_CONTACT_ERROR_UNIQUE_ALIAS

A subsequent update test including state returned:

0 records imported. 0 records updated. 0 records already exists.

There is another unusual issue: the initial three-column import placed the value 1 in the contact's State or County field, even though the CSV contained no state column.

Could you please examine the attached successful and unsuccessful CSV samples and advise:

Why adding standard fields causes the update to fail or skip the record.

How to reliably import and update the complete set of Joomla Contact fields.

How to include Joomla custom fields, particularly text, list, calendar, and textarea fields.

Our intention is to import a substantial number of marketing contacts with their full details. We need a reliable bulk-import method rather than manually completing individual records.

Thank you for your assistance.

Joomla Fry
100%
Posts: 1118
October 10, 2026

Please update TF Library. The issue of "state" field and other issues are resolved.

For importing custom fields, instead of column name in the first row of CSV file, use the ID of the custom field.

Login to Reply