View source for Template:Infobox filmography list/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
'''<nowiki>{{Infobox filmography list}}</nowiki>''' is the standard infobox for [[filmography]] list articles, it is designed to show a summary of the artist filmography.
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

<!-- Please edit from below onwards -->

==Usage==
The infobox may be added by pasting the template as shown below into an article and then filling in the desired fields. Any parameters left blank or omitted will not be displayed.

===Blank syntax===

====Format 1====
This format is highly recommended for usage in South Korean filmography list article.

For other countries filmography list article. Use [[#Format 2|Format 2]] instead.
{{Parameter names example|name|image|image_upright|alt|caption|film|television_film|television_series|web_series|television_show|web_show|radio_show|documentary|hosting|music_videos|narrating|theatre|advertisting|directing|others}}
<syntaxhighlight lang="html" style="overflow:auto; line-height:1.2em;">
{{Infobox filmography list
| name              = <!-- Use name_performances to display performances instead of filmography -->
| image             = <!-- filename only, no "File:" or "Image:" prefix, and no enclosing [[brackets]] -->
| image_upright     = 
| alt               = <!-- descriptive text for use by speech synthesis (text-to-speech) software -->
| caption           = 
| film              = 
| television_film   = 
| television_series = 
| web_series        = 
| television_show   = 
| web_show          = 
| radio_show        = 
| documentary       = 
| hosting           = 
| music_videos      = 
| narrating         = 
| theatre           = 
| advertising       = 
| directing         = 
| others            = 
}}
</syntaxhighlight>

{{Clear}}

====Format 2====
{{Parameter names example|name|image|image_upright|alt|caption|film|television_film|television|web_series|radio_show|documentary|hosting|music_videos|narrating|theatre|advertisting|directing|others}}
<syntaxhighlight lang="html" style="overflow:auto; line-height:1.2em;">
{{Infobox filmography list
| name              = <!-- Use name_performances to display performances instead of filmography -->
| image             = <!-- filename only, no "File:" or "Image:" prefix, and no enclosing [[brackets]] -->
| image_upright     = 
| alt               = <!-- descriptive text for use by speech synthesis (text-to-speech) software -->
| caption           = 
| film              = 
| television_film   = 
| television        = 
| web_series        = 
| radio_show        = 
| documentary       = 
| hosting           = 
| music_videos      = 
| narrating         = 
| theatre           = 
| advertising       = 
| directing         = 
| others            = 
}}
</syntaxhighlight>

{{Clear}}

===Example===
====Format 1====
{{Infobox filmography list
| name              = Im Yoon-ah
| image             = YoonA at Asia Artist Awards on November 26, 2019.jpg
| image_upright     = 1
| alt               = Yoona at Asia Artist Awards in 2019
| caption           = Yoona in 2019
| film              = 1
| television_film   = 2
| television_series = 3
| web_series        = 4
| television_show   = 5
| web_show          = 6
| radio_show        = 7
| documentary       = 8
| hosting           = 9
| music_videos      = 10
| narrating         = 11
| theatre           = 12
| advertising       = 13
| directing         = 14
| others            = 15
}}
<syntaxhighlight lang="html" style="overflow:auto; line-height:1.2em;">
{{Infobox filmography list
| name              = Im Yoon-ah
| image             = YoonA at Asia Artist Awards on November 26, 2019.jpg
| image_upright     = 1
| alt               = Yoona at Asia Artist Awards in 2019
| caption           = Yoona in 2019
| film              = 1
| television_film   = 2
| television_series = 3
| web_series        = 4
| television_show   = 5
| web_show          = 6
| radio_show        = 7
| documentary       = 8
| hosting           = 9
| music_videos      = 10
| narrating         = 11
| theatre           = 12
| advertising       = 13
| directing         = 14
| others            = 15
}}
</syntaxhighlight>

{{Clear}}

====Format 2====
{{Infobox filmography list
| name              = Robert Downey Jr.
| image             = Robert Downey Jr 2014 Comic Con (cropped).jpg
| image_upright     = 1
| alt               = Robert Downey Jr at 2014 Comic-Con
| caption           = Downey in 2014
| film              = 1
| television_film   = 2
| television        = 3
| web_series        = 4
| radio_show        = 5
| documentary       = 6
| hosting           = 7
| music_videos      = 8
| narrating         = 9
| theatre           = 10
| advertising       = 11
| directing         = 12
| others            = 13
}}
<syntaxhighlight lang="html" style="overflow:auto; line-height:1.2em;">
{{Template:Infobox filmography list
| name              = Robert Downey Jr.
| image             = Robert Downey Jr 2014 Comic Con (cropped).jpg
| image_upright     = 1
| alt               = Robert Downey Jr at 2014 Comic-Con
| caption           = Downey in 2014
| film              = 1
| television_film   = 2
| television        = 3
| web_series        = 4
| radio_show        = 5
| documentary       = 6
| hosting           = 7
| music_videos      = 8
| narrating         = 9
| theatre           = 10
| advertising       = 11
| directing         = 12
| others            = 13
}}
</syntaxhighlight>

{{Clear}}

==Parameters==
{| class="wikitable"
|+ List of parameters
! scope="col" colspan="2" | Parameter
! scope="col" | Required
! scope="col" | Description
|-
! scope="col" rowspan="2" | Name
| <code>name</code><br>
| {{yes}}
| rowspan="2" | Set the name of the artist. If parameter is empty, article title will display instead.<br>Use <code>name_performances</code> to display performances instead of filmography.
|-
| <code>name_performances</code>
| {{maybe|Optional}}
|-
! scope="col" rowspan="5" | Image
| <code>image</code>
| {{no}}
| Set the image to be displayed in the infobox.<br>'''Do not include <code>File:</code> or <code>Image:</code> prefix and no enclosing <code><nowiki>[[brackets]]</nowiki></code>'''.
|-
| <code>image_upright</code>
| {{no}}
| Scales the image thumbnail from its default size by the given factor.<br>Values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%).
|-
| <code>alt</code>
| {{no}}
| Set [[MOS:ALT|descriptive alternative text]] for visually impaired readers.
|-
| <code>caption</code>
| {{no}}
| Set caption for the image.
|-
| <code>image_size</code>
| {{no}}
| {{strongbad|Deprecated}}. [[WP:THUMBSIZE|It is not recommended to use this parameter]], use <code>image_upright</code> instead.
|-
! scope="col" | Film
| <code>film</code>
| {{no}}
| Set the total number of film, the artist has filmed.
|-
! scope="col" | Television film
| <code>television_film</code>
| {{no}}
| Set the total number of television film, the artist has filmed.
|-
! scope="col" | Television series
| <code>television_series</code>
| {{no}}
| Set the total number of television series, the artist has filmed.
|-
! scope="col" | Web series
| <code>web_series</code>
| {{no}}
| Set the total number of web series, the artist has filmed.
|-
! scope="col" | Television show
| <code>television_show</code>
| {{no}}
| Set the total number of television show, the artist has filmed.
|-
! scope="col" | Web show
| <code>web_show</code>
| {{no}}
| Set the total number of web television show, the artist has filmed.
|-
! scope="col" | Television
| <code>television</code>
| {{no}}
| {{stronggood|Recommended for non-Korean filmography article}}.<br>{{strongbad|Remember to remove <code>television_series</code> and <code>television_show</code> parameters else this parameter will not work}}.<br>Set the total number of television appearances.
|-
! scope="col" | Radio show
| <code>radio_show</code>
| {{no}}
| Set the total number of radio show, the artist has filmed/recorded/participated.
|-
! scope="col" | Documentary
| <code>documentary</code>
| {{no}}
| Set the total number of documentary, the artist has filmed/recorded.
|-
! scope="col" | Hosting
| <code>hosting</code>
| {{no}}
| Set the total number of events, the artist has hosted.
|-
! scope="col" | Music videos
| <code>music_videos</code>
| {{no}}
| Set the total number of music videos appearances.
|-
! scope="col" | Narrating
| <code>narrating</code>
| {{no}}
| Set the total number of narrated works.
|-
! scope="col" | Theatre
| <code>theatre</code>
| {{no}}
| Set the total number of theatre appearances.
|-
! scope="col" | Advertisting
| <code>advertising</code>
| {{no}}
| Set the total number of advertisement, the artist has advertised for.
|-
! scope="col" | Others
| <code>others</code>
| {{no}}
| Set the total number of other works, the artist has participated in.<br>For example, appearance as video game character.
|}

==TemplateData==
{{TemplateData header}}
<templatedata>
{
    "description": "",
    "params": {
        "name": {
              "description": "Set the name of the artist. If parameter is empty, article title will display instead. Use name_videography to display videography instead of filmography",
              "label": "name",
              "required": true,
              "type": "string"
        },
        "name_performances": {
              "description": "Set the name of the artist. If parameter is empty, article title will display instead. Use name to display filmography instead of performances",
              "label": "name_performances",
              "required": false,
              "type": "string"
        }, 
        "image": {
              "description": "Set the image to be displayed in the infobox. Do not include File: or Image: prefix and no enclosing [[brackets]].",
              "label": "image",
              "required": false,
              "type": "wiki-file-name"
        },
        "image_upright": {
              "description": "Scales the image thumbnail from its default size by the given factor. Values less than 1 scale the image down (0.9 = 90%) and values greater than 1 scale the image up (1.15 = 115%).",
              "label": "image_upright",
              "required": false,
              "type": "number"
        },
        "alt": {
              "description": "Set descriptive alternative text for visually impaired readers.",
              "label": "alt",
              "required": false,
              "type": "string"
        },
        "caption": {
              "description": "Set caption for the image.",
              "label": "caption",
              "required": false,
              "type": "string"
        },
        "image_size": {
              "description": "Deprecated. It is not recommended to use this parameter, use image_upright instead.",
              "label": "image_size",
              "required": false,
              "type": "string"
        },
        "film": {
              "description": "Set the total number of film, the artist has filmed.",
              "label": "film",
              "required": false,
              "type": "number"
        },
        "television_film": {
              "description": "Set the total number of television film, the artist has filmed.",
              "label": "television_film",
              "required": false,
              "type": "number"
        },
        "television": {
              "description": "Recommended for non-Korean filmography article. Set the total number of television appearances.",
              "label": "television",
              "required": false,
              "type": "number"
        },
        "television_series": {
              "description": "Set the total number of television series, the artist has filmed.",
              "label": "television_series",
              "required": false,
              "type": "number"
        },
        "web_series": {
              "description": "Set the total number of web series, the artist has filmed.",
              "label": "web_series",
              "required": false,
              "type": "number"
        },
        "television_show": {
              "description": "Set the total number of television show, the artist has filmed.",
              "label": "television_show",
              "required": false,
              "type": "number"
        },
        "web_show": {
              "description": "Set the total number of web television show, the artist has filmed.",
              "label": "web_show",
              "required": false,
              "type": "number"
        },
        "radio_show": {
              "description": "Set the total number of radio show, the artist has filmed/recorded/participated.",
              "label": "radio_show",
              "required": false,
              "type": "number"
        },
        "documentary": {
              "description": "Set the total number of documentary, the artist has filmed/recorded.",
              "label": "documentary",
              "required": false,
              "type": "number"
        },
        "hosting": {
              "description": "Set the total number of events, the artist has hosted.",
              "label": "hosting",
              "required": false,
              "type": "number"
        },
        "music_videos": {
              "description": "Set the total number of music videos appearances.",
              "label": "music_videos",
              "required": false,
              "type": "number"
        },
        "narrating": {
              "description": "Set the total number of narrated works.",
              "label": "narrating",
              "required": false,
              "type": "number"
        },
        "theatre": {
              "description": "Set the total number of theatre appearances.",
              "label": "theatre",
              "required": false,
              "type": "number"
        },
        "advertising": {
              "description": "Set the total number of advertisement, the artist has advertised for.",
              "label": "advertising",
              "required": false,
              "type": "number"
        },
        "others": {
              "description": "Set the total number of other works, the artist has participated in. For example, appearance as video game character.",
              "label": "others",
              "required": false,
              "type": "number"
        }
    }
}
</templatedata>

==Tracking category==
* {{Category link with count|Pages using infobox filmography list with unknown parameters}}
<includeonly>{{sandbox other||
[[Category:WikiProject Television templates]]
[[Category:WikiProject Film templates]]
[[Category:Television infobox templates|Filmography]]
[[Category:Film infobox templates|Filmography]]
[[Category:Templates that add a tracking category]]
}}</includeonly>