# SubmissionFlair

class `praw.models.reddit.submission.``SubmissionFlair`(submission)

  Provide a set of functions pertaining to Submission flair.

  `__init__`(submission)

    Create a SubmissionFlair instance.

    Parameters: | submission – The submission associated with the flair functions.

  `choices`()

    Return list of available flair choices.

    Choices are required in order to use `select()`.

    Example:

        choices = submission.flair.choices()

  `select`(flair_template_id, text=None)

    Select flair for submission.

    Parameters:

    - flair_template_id – The flair template to select. The possible `flair_template_id` values can be discovered through `choices()`.
    - text – If the template’s `flair_text_editable` value is True, this value will set a custom text (default: None).

    For example, to select an arbitrary editable flair text (assuming there is one) and set a custom value try:

        choices = submission.flair.choices()
        template_id = next(x for x in choices
                           if x['flair_text_editable'])['flair_template_id']
        submission.flair.select(template_id, 'my custom value')