Submitting Devices to WURFL


If you are a commercially licensed customer who has downloaded the wurfl.xml file from the customer vault (i.e. licensed repository), you may submit a request to to add new User Agents (UA). Once a device is approved and added to WURFL, the change will be reflected in an upcoming snapshot release.

Obtaining a License

Aside from the ability to submit devices to WURFL, there are many other advantages to being a licensed user. A commercial license provides customers with access to more capabilities, frequent updates of the WURFL DDR files and increased support levels. Click here to learn more about obtaining a license.

Cloud Users

Licensed WURFL Cloud users will also be able to submit devices to WURFL. While cloud customers do not recieve or use a wurfl.xml file, they will have access to the WURFL Cloud Client which provides a constantly updated cloud repository. Click here to learn more about WURFL Cloud.

When to Submit a Device(s)

  • If you have a UA that is not being accurately detected by WURFL.

  • If a device is not returning the expected values for a capability.


    • Make sure you are using the most current wurfl.xml.

    • If you are running the API in high performance mode and are running into issues with capability values, try switching to high accuracy mode.

    • If possible, upgrading your API to the most current version could help as logic may undergo change to improve accuracy.

    • If you would like to define a new device, please do not submit it for addition to WURFL. Instead, consider using a patch file for this task.


The UA should be listed in the exact format as seen in the HTTP Header. If you are submitting a device because it is not being detected properly, please include the capability's returned value along with the expected value when possible.

If you plan on submitting a list of 30 or more unique UAs, we ask that it be in a list with two tab separated fields:

  • UA
  • Count/Number of Hits


user_agent  count
Mozilla/5.0 (Linux; U; Android 4.4.2; ru-ru; SM-G350E Build/KOT49H) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30 97543
Mozilla/5.0 (Linux; U; Android 4.2.2; ru-ru; GT-I9105 Build/JDQ39) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30  93027
Mozilla/5.0 (Linux; U; Android 4.3; ru-ru; GT-I9300 Build/JSS15J) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30   53216