.. _per_group: per_group ========= The **per_group** parameter controls how **sort**, **offset**, and **limit** are applied when :ref:`group_by_source ` is enabled. When **per_group** is false, sorting and pagination are applied to the complete result set before it is divided into source groups. When **per_group** is true, they are applied independently within each source group. For example, a **limit** of 10 returns up to 10 matching objects for each source. The default value is false. Setting **per_group** to true without also setting **group_by_source** to true returns an error. This parameter is supported by: * **FindEntity** * **FindConnection** * **FindBlob**, **FindImage**, and **FindVideo** * **FindDescriptor**, and **FindDescriptorBatch** * **FindBoundingBox** and **FindPolygon** * **FindFrame**