How do I create a group based on an HTML content match (e.g. capture tags)?

Modified on: Wed, 1 Jul, 2026 at 9:39 PM

Summary

Create groups based on HTML content matches when URL or title matching is not suitable. Supported approaches include breadcrumb navigation paths and HTML meta tags such as author, department, and group tags. Configuration requires assistance from Siteimprove technical support before groups can be created and used within Content and Analytics services.

Prerequisites

Note: Only Administrators, Account Owners, or a custom role with the "manage groups" permission can create/edit groups.

Preparation requirements

Groups help you to manage your content within the Siteimprove platform. Groups can be created in the Content suite (QA, SEO, Accessibility) and/or Analytics. For more information on types of groups see What is a group?.

Groups can often be created using a simple match based on page titles or URLs. See How do I create a group based on a URL/title match.

If your website URL/titles are not suitable for a simple group match, you can use an HTML match as described in this article.

Here are some examples of HTML page content that can be used to define groups:

A breadcrumb navigation path.
The author of the page.
Department/Group names.

To configure groups based on an HTML match, you do need the help of Siteimprove technical support. However, this article explains the options available, steps you can take to prepare, and how the groups are created.

Scenario 1: Breadcrumb-based groups

To do this, you will need a consistent breadcrumb navigation path on your website.

Contact Siteimprove technical support to create groups in both the Content suite (QA, SEO, Accessibility) and Analytics based on your breadcrumb navigation path.

The support team will use the breadcrumb CSS selector and HTML tags to capture the breadcrumb information on each page. Afterward, you can create the group as described below.

With the site selected, go to " Settings > Groups from the main menu.
Click on " Create Group ".
Give the group a name.
Select the service “ Content Only ”.
Click on " Add group match " under the Matches section.
Choose to include the match type “ Capture tag ”.
Under match conditions, select “ breadcrumbs ”.
Enter text which matches the breadcrumb navigation path for the pages you want to group together. (e.g., if a breadcrumb path is: Home > Press > Press Releases, the match ‘press’ would create a group containing pages in the press area of your website.)
Click on “ Save Changes ” and the group is ready for use in the content modules (i.e. QA, Accessibility, SEO).

See How do I edit user access to Sites and Groups in Siteimprove? regarding group access for users.

Analytics

With the site selected, go to Settings > Groups from the main menu.
Click on "Create Group".
Give the group a name.
Select the service “ Analytics Only ”.
Click on " Add group match " under the Matches section.
Choose to include the Match type, “ Capture tag ”.
Under Match conditions, enter text matching the breadcrumb navigation path for the pages you want to group together.
Click on “Save Changes” and your group is ready for use in the Analytics service.

Scenario 2: Meta tag-based groups

For this explanation, we will use an “author” meta tag. Other meta tags can also be used in a similar way. You can even add a “group” meta tag to help manage your content within the platform.

If your page contains the author's name within an HTML meta tag, Siteimprove allows you to create groups based on these tags.

The “author” HTML meta tag looks like this:

Once the author meta tag is present, inform Siteimprove technical support that you would like groups in both the Content suite (QA, SEO, Accessibility) and Analytics based on the tag. Please provide the support team an example of a page containing the meta tag.

Note: When configured by support, these groups will be created automatically in Analytics. They can be created automatically in the Content suite, but here you also have the option to create them manually.

If the value in the meta tag is an email address of a user in the Siteimprove platform, then the groups can be assigned to these users automatically.

Please discuss these options with the support agent handling your request.

Creating a Content group based on author tag if not added automatically.

With the site selected, go to Settings > Groups from the main menu.
Click on "Create Group".
Give the group a name.
Select the service “ Content Only ”.
Click on " Add group match "
Choose to include the Match type “ Meta tag ”.
Under match conditions, select author.
Enter the name of the author as it appears in the meta tag.
Click on “Save Changes” and your group is ready for use in the Content suite.

See How do I edit user access to Sites and Groups in Siteimprove? regarding group access for users.

Analytics

When configured by support, these groups are created automatically in Analytics. The name of the group will be the name of the author as seen in the meta tag.

Support requirements / automatic group creation notes

Contact Siteimprove technical support to create groups in both the Content suite (QA, SEO, Accessibility) and Analytics based on your breadcrumb navigation path.

If the value in the meta tag is an email address of a user in the Siteimprove platform, then the groups can be assigned to these users automatically.

Please discuss these options with the support agent handling your request.

If you have any questions regarding groups, please submit a request to the Siteimprove support team and we will be happy to help.

Did you find it helpful? Yes No