CiviCRM Community Forums (archive)

I'm trying to understand more fully what the token {action.forward} actually does, but can't find much in the current documentation.

From what I can see it provides a click-through to a form where the user can enter up to 5 names and addresses, to whom the message in question will be forwarded.

From what I've read, CiviCRM then checks these contacts against those already in the database, creates new contacts as required, and then forwards the message only to those contacts that have not already been sent the mailing via other means (i.e. they may have been on the original mailing list to which the message was foist sent, or they may have been sent the message already via another user utilising the {action.forward} token).

What I'm unsure of currently is:

Are the contacts identified via the forwarding form linked to the contact record of the user submitting the form via a relationship?

Are newly created records added to the group that received the original mailing?

Are these records easily identifiable via any means - the mailing report or a search, perhaps?

Thanks for any tips on this.

Thanks for the clarification Lobo. I can certainly have a go at the documentation side of things. As for coding, my skills there remain severely limited for the time being.