Requirements¶

The docx file must have a single table with a single row in it. That row can have one or more cells in it where each cell will be for a different person. You can nest a table inside a single cell if your design requires that. Each cell in that one row must be identical. So typically you would construct the first cell then copy and paste that cell’s contents into the other cells on the row.

Replacement Codes¶

In addition to any of the normal replacement codes used for email, you can use the following special purpose replacement codes.

The following can be inserted into an email to verify someone’s personal information, or can be used in confirmations, such as Donation Confirmation emails. They can also be used in these DocX Directories.

{familyname}

• If there is no spouse, it will be the name of the individual (same as {name} above)

• If the CoupleName extra value field exists on the family record, this will be used

• If the lastname of the Spouse is not the same as the head of household, the result will be something like “Jim Sutton & Linda Thompson”

• Otherwise, it will be something like “Jim & Linda Sutton”

{familytitle}

• If there is a FamilyName extra value field on the family record, this will be used

• Otherwise, it will say something like “The Sutton Family”

{lastname}

The last name of the individual

{firstnames}

This is typically used when you are creating a family directory where the {familytitle} is used as a header over the family.

• If there is no spouse, it will be the preferred name (goesby or first) of the individual

• If the lastname of the Spouse is not the same as the head of household, the result will be something like “Jim & Linda Thompson”

• Otherwise it will be something like “Jim & Linda”

{addr}

The complete mailing address on multiple lines.

{bday}

This returns a birthdate or blank if none is available.

• If you just use {bday}, it will return something like “Aug 16”

• If you use something like {bday:Birthday: _M/d/yy_}, it will return something like “Birthday: 8/16/52”.

Every thing beyond the first bday: is the text that will be printed.

What is between the two underscore characters is the format for the birthdate. That is a special replacement code inside this replacement code.

{anniversary}

This returns an anniversary date or blank if none is available.

This replacement code works the same way as {bday} above.

{email}

This returns the email address of the individual.

• If you just use {email}, it will return the email address of the individual.

• If you use something like {email:_first_: _addr_}, it will return something like “Jim: jamessutton2@gmail.com”

{spemail}

This returns the email address of the spouse, if any.

This works the same way as {email} above.

{phone}

This will return the Home Phone number.

• If the Home Phone is empty, a blank is returned.

• If the individual has DoNotPublishPhones checked, a blank is returned.

• If you just use {phone} the formatted phone number is returned.

• If you use something like {phone:H _number_}, it will return something like “H 901-758-1888”.

{cell}

This will return the individual’s Cell Phone number.

• If the Cell Phone is empty, a blank is returned

• If the individual has DoNotPublishPhones checked, a blank is returned.

• If you just use {cell} the formatted phone number is returned.

• If you use something like {cell:C _number_}, it will return something like “C 901-489-0622”.

• If you use something like {cell:C _first _number_}, it will return something like “C Jim 901-489-0622”.

{spcell}

This will return the spouse’s Cell Phone number.

This works the same way as {cell} above.

{spouse}

This will return the spouse’s name, “first last”

• If there is no spouse, nothing is returned.

• If you just use {spouse} only the name is returned.

• If you use something like {spouse:Spouse: _name_}, it will return something like “Spouse: Linda Sutton”

{kids}

This will return a comma separated list of Kids first names.

• If there are no children, nothing will be returned.

• If you use just {kids} it will look something like “Susan, Bobby, Tammy”

• If you use something like {kids:Children: _names_}, it will look something like “Children: Susan, Bobby, Tammy”.

{pic width height}

This will return the individual’s picture of a specific size.

• You must include decimal number of inches for both width and height.

• If there is no picture, it will return nothing.

• If you use something like {pic .65 .97}, the picture will be sized exactly .65 inches wide by .97 inches tall.

{fampic width height}

This will return the family’s picture of a specific size.

This works the same way as {pic above.

Including optional lines in the output¶

The replacement codes that allow you to include text after a colon (as in {kids:_names}) can include a line break like so:

{familyname}
{kids:_names_
}{phone}

This means that if there are no kids, no space (line) will be in the output. So in the above case, with no kids, the phone number would start immediately below the familyname where the kids would normally show up.