diff --git a/PURL-TYPES.rst b/PURL-TYPES.rst
index 64a1342..32cbfe8 100644
--- a/PURL-TYPES.rst
+++ b/PURL-TYPES.rst
@@ -586,6 +586,52 @@ swift
       pkg:swift/github.com/Alamofire/Alamofire@5.4.3
       pkg:swift/github.com/RxSwiftCommunity/RxFlow@2.12.4
 
+
+YOCTO Linux
+-----------
+``yocto`` for Yocto Linux recipes:
+
+The default repository is: ``https://git.yoctoproject.org/``
+
+:namespace: The namespace is the name of the layer which provides the recipe.
+:name: The name is the name of the recipe.
+:version: The version is a commit or tag
+
+Qualifiers
+^^^^^^^^^^
+All qualifiers should be percent-encoded.
+
+``repository_url``
+  The base repository. 
+  In example:
+  
+  * ``https%3A%2F%2Fgithub.com%2FXilinx``
+  * ``https%3A%2F%2Fgithub.com%2Fopenembedded%60``
+  
+  The protocol can be ``https``, ``ssh``  or ``git`` and is mandatory.
+  **Default:** ``https%3A%2F%2Fgit.yoctoproject.org%2F``
+
+``pv``
+  pv is the version of the package itself.
+``arch``
+  Optional for the architecture like ``mips64`` or ``arm64``
+
+Subpath
+^^^^^^^
+The subpath is mandatory if the recipe is not in the root direcotry of the
+repository.
+
+Examples
+^^^^^^^^
+
+::
+
+  pkg:yocto/poky/python-3dbus@f1ad013?pv=1.2.18#meta/recipes-devtools/python
+  pkg:yocto/openembedded-core/glibc@9400e1e9208b0f9075dfdfce0a3d1318a7fe6bf4?pv=2.35&repository_url=https%3A%2F%2Fgit.openembedded.org#meta/recipes-core/
+  pkg:yocto/meta-xilinx-core/u-boot-zynq-uenv@06e35a4#recipes-bsp/u-boot/
+  pkg:yocto/meta-odroid/emmc@4e07fab?pv=1.0.0&repository_url=https%3A%2F%2Fgithub.com%2Fakuster#recipes-bsp/
+
+
 Other candidate types to define:
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -634,7 +680,6 @@ Other candidate types to define:
 - ``vagrant`` for Vagrant boxes
 - ``vim`` for Vim scripts packages:
 - ``wordpress`` for Wordpress packages:
-- ``yocto`` for Yocto recipe packages:
 
 
 License
diff --git a/test-suite-data.json b/test-suite-data.json
index d9741a9..16565d1 100644
--- a/test-suite-data.json
+++ b/test-suite-data.json
@@ -646,5 +646,17 @@
     "qualifiers": null,
     "subpath": null,
     "is_invalid": true
+  },
+  {
+    "description": "yocto valid recipe",
+    "purl": "pkg:yocto/poky/python-3dbus@f1ad013?pv=1.2.18#meta/recipes-devtools/python/",
+    "canonical_purl": "pkg:yocto/poky/python-3dbus@f1ad013?pv=1.2.18#meta/recipes-devtools/python",
+    "type": "yocto",
+    "namespace": "poky",
+    "name": "python-3dbus",
+    "version": "f1ad013",
+    "qualifiers": {"pv": "1.2.8"},
+    "subpath": "meta/recipes-devtools/python",
+    "is_invalid": false
   }
 ]