Populating list option via a manual file import

Last Updated: 2/7/2026     Tags: subscriber, profile, subscribers, list, taguchi
  • Switch Version
  • V5
  • V4

When you import subscribers via a manual file import, you can also populate or update a list option field for each subscriber. This is useful if you want to assign subscribers to specific segments or categories inside a list without using web forms or APIs.

Prerequisites

  • You have a list option already created inside your Taguchi list.
  • Your import file (CSV, TSV, or XLSX) contains a column with the list option values (e.g., "WA", "NSW", "QLD").

Step-by-step guide

  1. Prepare your import file so it includes a separate column for the list option value. Please refer to the sample table below:
email first_name list_option
john@example.com John VIC
jane@example.com Jane NSW
bob@example.com Bob VIC
sarah@example.com Sarah ACT
mike@example.com Mike QLD
emma@example.com Emma WA

In this example, subscribers are being assigned list options based on their Australian state/territory (VIC, NSW, etc.).

  1. Go to Subscribers → Import Subscribers and upload your file.

  2. In the field mapping step of the file import dialog, map your file column to the list_option field (not a custom field).

    Populate a list option via a manual file import

  3. Complete the import. Taguchi will assign each subscriber the corresponding list option value.

What the updated list subscription options look like

After a successful import, you'll see the list option populated accordingly when you view a subscriber's profile:

Populate a list option via a manual file import

The screenshot above shows an example of how the updated list subscription options appear after the import.

What happens after import?

  • Each subscriber's list option will be updated or set according to your file.
  • You can later use these list options for:
    • Targeting campaigns (list option is "WA")
    • Personalization
    • Journey branching

Troubleshooting

Issue Likely cause
List option not updating You mapped to a custom field instead of list_option.
Import fails validation The value in your file doesn't match an existing list option name exactly (case‑sensitive).
Multiple list options? A subscriber can only have one list option per list. This import overwrites, not appends.

Need help?

If you have questions about populating list options or need assistance with your import:

  1. Review the troubleshooting steps above
  2. Check the related articles for additional context
  3. Contact Taguchi Support for personalized assistance