Query by Section Page Group

You can use this query type to get content items that have been placed in a specified group on the active section page of a specified section.

This query type returns curated content: content items that have been explicitly selected and placed on the section page in a deliberate order by an editor or journalist. Therefore, this query type has no sort options or date filters - content selection and ordering has already been done.

The Query by section page group form contains the following fields:

Section selection mode

The value you select here determines both how the Section field operates and how the value you enter in the Section field is used. The following options are available:

Publication-specific

If you select this option, then the Section field lets you choose a specific section belonging to a specific publication. The query will then always select content items from this specific section.

Context-dependent

If you select this option, then the Section field lets you choose a section without reference to which publication it belongs to. The query will then select content items from the selected section in the current publication (that is, the publication named in the request URL).

For the Context-dependent option to be useful, your publications must include sections that have both identical titles and identical unique names.

Section

The name of the section you are interested in. Once you start typing, a drop-down menu is displayed containing a list of all sections that match the characters you have typed. You will see that the way the section titles are listed depends on the option you selected in the Section selection mode field.

If you do not specify a section, then Section selection mode is ignored, and content items are selected from the current section of the current publication (that is, the publication and section named in the request URL).

Group

The section page group you are interested in. Once you start typing, a drop-down menu is displayed containing a list of all groups that match the characters you have typed. Select the group you want and it is displayed as a token in the field. When you are looking for the group you want, bear in mind that:

  • The names listed are the names of the group types defined in section page templates, not the group instances on actual section pages. On actual section pages, the group type name appears on the right side of the group. The instance name is often the same as the type name, but does not need to be.

  • All group type names are listed, not just those in the section you have selected. It is up to you to make sure that you select a group that actually appears on your selected section's active section page.

Group instance

The same group type can be used several times on the same page. Select the specific instance you want to use. Select2, for example, to use the second occurrence of the group on the page.

Content types

The names of the content types you want to be selected. Once you start typing, a drop-down menu is displayed containing a list of all content types that match the characters you have typed. Select the content type you are interested in. The selected name is then displayed as a token in the field. You can repeat this process to enter many content types.

Start at

The position at which you want to start selecting content items from the group. If, for example, you specify 5, then the first four content items in the group are ignored, and selection starts at the fifth item.

Maximum items

The maximum number of content items you want to be selected by this query.

There is another Maximum items setting on the Queries tab that is applied to the total result set returned by all your queries. If set, it can potentially override this setting. See Queries for details.