Skip to main content

Test recipients

The <test_recipients> section is a container where you can choose to:

  • Add test recipients directly to the XML instructions file
  • Specify a CSV file that contains the appropriate test recipientsWe recommend using a CSV file instead of adding the test recipients directly, to separate test recipient addresses from the campaign data.

The <test_recipients> section is:

  • A child of the Recipients sectionYou can add test recipients using either <test_recipients> or the Filter section. See the Recipients section for more details.
  • Positioned:
    • After new_recipients if used, within the <recipients> section of the XML instructions file
    • Otherwise after the <retry /> tagIf no <retry /> tag or <new_recipients> are used, the <test_recipients> section is the first entry within the <recipients> section.

The <test_recipients> section includes the following children:

ChildTypeDescriptionUse
test_recipientelementAdd test recipients directly to the XML.Choose <test_recipient> or <csv_file>
test_csv_fileelementUpload a CSV file containing the test recipients.Choose <test_recipient> or <csv_file>

Use

  • You cannot use both <test_recipient> and <csv_file> for the same delivery
  • You should use a <test_recipient> tag for only one recipient. For more recipients you have to use multiple <test_recipient> tags
  • You cannot exceed the maximum number of 30 test recipients
    • Excess test recipients are ignored

Regardless of whether you add test recipients directly, or upload a CSV file, XMLDelivery adds the relevant data to your Contactsend user database and automatically creates the relevant filter. See Filtering and added recipients for more about how the user database is filtered to match new recipients.

Examples:

Send a test delivery to bob@hisemail.com and henry@hisemail.com

    <test_recipients>
<test_recipient>
<email>bob@hisemail.com</email>
<first_name>bob</first_name>
</test_recipient>
<test_recipient>
<email>henry@hisemail.com</email>
<first_name>henry</first_name>
</test_recipient>
</test_recipients>

Send a test delivery to the recipients in file.csv

    <test_recipients>
<test_csv_file>file.csv</test_csv_file>
</test_recipients>