What is the TestNG.xml file?

· Read in about 2 min · (393 words) ·

TestNG.xml file is an XML file which contains all the Test configuration and this XML file can be used to run and organize our test. TestNG eclipse plugin can be used to automatically generate testng.xml file so no need to write from scratch. In this article, we are going to learn about what is testng.xml and how to use testng.xml file to run our test.

Create Class with multiple @test methods:

First, we need to create a simple class which contains multiple @test methods.

package com.tutorial.testng;

import org.testng.annotations.Test;

public class RunMultipleTestCasesfromXml {
    public void testMethod1() {
        System.out.println("Running @Test - testMethod1");

    public void testMethod2() {
        System.out.println("Running @Test - testMethod2");

    public void testMethod3() {
        System.out.println("Running @Test - testMethod3");

    public void testMethod4() {
        System.out.println("Running @Test - testMethod4");

We can run this test class directly by Right click and Run As testNg option from the Eclipse but we are goign to create an xml file here.

Create TestNg.xml file:


Right click on the Test Class and then select TestNG –> Convert to TestNG. right-click-convert-to-testng


After the first step, you will see a window where we can select the location where testng.xml file should be generated.You can set any name for your xml file, by default name is testng.xml. You should be able to edit the preview section and update the XML file here. generate-testng-file-browse


Next window will show you the changes you can do in yours JAVA files.You can ignore this step as we have already updated Java class, So just ignore and click finish button. changes-in-java-files


After the last and final Step you will be able to see a testng.xml file generated in the base directory of your project.If you open the .xml file you can notice our Test Class is present in the classes tag which is under the test name="Test” Tag. It means our Class would be considered as Test Class by TestNG. generated-testng-file-in-eclipse

TestNG.xml file sample:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Suite">
  <test name="Test">
      <class name="com.tutorial.testng.RunMultipleTestCasesfromXml"/>

Run TestNG.xml file:

Right Click on the testng.xml file and the select Run As –> TestNG Suite right-click-run-as-testng-suit

When you run your testng.xml file, it will start running your @test methods from the class mentioned in the XML and generate the report. You can see our all the @test methods ran successfully. testng-multiple-test-report