When and Why to Use

Use this when you need a complete roster of children within an age window, including:

• total count,
• each child’s age (with optional recodes),
• each child’s gender,
• a readable “name” label (e.g., “16 year old son”) for downstream questions.

Great for: youth-targeted studies, quota setup, segmentation, or routing follow-ups to each child profile.

Chat Experience

• Three-step flow: count → ages → genders.
• Copy for each step is customizable via question_1_text–question_3_text.
• Gender terms shown to respondents can be mapped to “son/daughter” (or alternatives) via gender_map.

Traditional Experience

• Sequential screens and compact multi-field forms.
• Numeric input for count/ages; single/multi-select for genders.
• Summary list of created child records before proceeding (optional).

Configuration Options

Option	Type	Required	Default	Description
min_age	int	yes	—	Minimum eligible age.
max_age	int	yes	—	Maximum eligible age.
age_recodes	Optional[Dict[int, str]]	no	None	Map raw ages to recoded labels (e.g., 13: "Secondary").
gender_map	Optional[Dict[str, str]]	no	{ "Male": "son", "Female": "daughter" }	Maps gender → child term used in the “name” label.
question_1_text	Optional[str]	no	"How many children do you have between the ages of {min_age} and {max_age}?"	Custom text for count prompt.
question_2_text	Optional[str]	no	"For each child, please let us know their age"	Custom text for ages prompt.
question_3_text	Optional[str]	no	"Now, please let us know their gender"	Custom text for genders prompt.

Return Value

List[StringResponse] — One StringResponse per child, with tags attached:

• age: the recoded age (if age_recodes supplied; otherwise raw age as string),
• gender: the selected gender,
• name: a readable label combining age and gender_map term (e.g., “16 year old son”).

If the respondent reports no eligible children, returns an empty list.

Example Code

Basic usage

from survey import Survey s = Survey(**globals()) children = s.get_all_children_age_gender( min_age=5, max_age=18, ) for child in children: s.text_question(f"What is {child.name}'s favorite subject in school?") s.complete()

With age recodes and custom gender terms

children = s.get_all_children_age_gender( min_age=5, max_age=17, age_recodes={ 5: "Pre-school", 6: "Primary", 7: "Primary", 8: "Primary", 9: "Primary", 10: "Primary", 11: "Secondary", 12: "Secondary", 13: "Secondary", 14: "Secondary", 15: "Secondary", 16: "Secondary", 17: "Secondary", }, gender_map={"Male": "boy", "Female": "girl"}, )

Custom question copy

children = s.get_all_children_age_gender( min_age=10, max_age=16, question_1_text="Between {min_age} and {max_age}, how many children live in your household?", question_2_text="Please enter each child's age.", question_3_text="Please select each child's gender." )

Notes

• Validation is performed on raw ages; age_recodes affect labels/reporting only.
• Expand gender options as needed (e.g., “Non-binary,” “Prefer not to say”); use gender_map to control the child term used in name.
• The name field is for respondent-friendly copy; avoid relying on it for programmatic logic—use age and gender tags instead.