At first you need to create some groups for your address records. To do this navigate to a sysfolder and switch to the list view. Click “Create new record” at the bottom, now click Address Group.

In that form the title is the only required field, if you have created some groups already you will see them in the tree view and can select one as the parent group for the group you are about to create. At the bottom you can add a small note or description to the group.

Adding groups to an address is as easy as adding a parent group to another group. Open the address record you want to assign a group to or create a new address record, go to the bottom of the form and add one or more groups from the right box by clicking on the group.

When adding groups to an address there's one point to be aware of: The top most group you assign to an address can be put out in the front end later, so you might want to choose that carefully or switch positions of the selected groups.

Go to the page view and navigate to the page where you want to insert one or more addresses. Create a new content element and in the “new content element wizard” scroll down to the plugins section and select “Address Selection”

Now on the first tab [1] you can add address records to the plugin, the second tab [2] is for selecting a template for how the address should look like, this needs to be configured by your administrator. If there're no templates on the second tab, just save the content element once and after saving it they should apear.

In the Single addresses field [3] you can select addresses by using the known element browser. Even if the addresses selected here would be selected via groups, too they do not appear twice in the front end.

In the groups field [4] you can select groups from the tree view. These groups get combined either by AND or by OR [5]. That means you can select addresses which are in all of the given groups (AND) or they are required to be in at least one of the given groups (OR).

The starting point does not necessarily need to be set. The extension can be configured to work with a default setting which needs to be adjusted by your administrator. If you set a startingpoint here, it will override that default setting that might be set. The recursive field [7] sets how deep in the page tree beginning from the startingpoint the system should look for addresses with the given groups.