Platform Groups
Platform Groups are the top-level categories that organise your platforms. Examples include Mobile OS, Desktop OS, or Browser. You must create at least one platform group before you can add platforms or generate configurations.
What platform groups do
Platform groups serve two purposes:
- Organisation — they visually group related platforms together in the Configurations page and in the configuration wizard.
- Combination logic — the wizard uses groups to enforce that each generated configuration picks at most one platform per group. This ensures combinations like "iOS + macOS" (one mobile, one desktop) but prevents nonsensical combinations like "iOS + Android" (two mobile platforms in a single configuration).
Creating a platform group
- Go to Admin → Configurations.
- Click Add Platform Group in the Platform Groups panel.
- Enter a Name for the group (e.g., Mobile OS, Desktop OS).
- Set a Display Order — lower numbers appear first in the wizard. Leave this as the default if order does not matter.
- Choose whether the group is Enabled.
- Click Save.
Editing a platform group
Click the edit action on any platform group row to update its name, display order, or enabled state. Changes take effect immediately.
Enabling and disabling a platform group
Disabling a platform group hides all of its platforms from the configuration wizard. Existing configurations that were already created from those platforms are not affected — they remain in the system. Only future wizard sessions are restricted.
Re-enable a group at any time to make its platforms available in the wizard again.
Deleting a platform group
Click the delete action on a platform group and confirm. The group and all of its platforms are permanently removed.
Deleting a platform group also deletes all platforms in it. If any of those platforms are part of existing configurations, those configurations may also be affected. Review your existing configurations before deleting a group.
Platform group properties
| Property | Description |
|---|---|
| Name | A unique display name for the group. Shown in the wizard and the Configurations page. |
| Display Order | Controls the sort order of groups in the wizard. Lower numbers appear first. Groups with the same order are sorted alphabetically. |
| Enabled | When disabled, the group's platforms are hidden from the configuration wizard. Existing configurations are unaffected. |