streamlit-nightly 1.46.2.dev20250712__tar.gz → 1.46.2.dev20250714__tar.gz

{streamlit_nightly-1.46.2.dev20250712/streamlit_nightly.egg-info → streamlit_nightly-1.46.2.dev20250714}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamlit-nightly
-Version: 1.46.2.dev20250712
+Version: 1.46.2.dev20250714
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/setup.py

@@ -23,7 +23,7 @@ from setuptools.command.install import install
 
 THIS_DIRECTORY = Path(__file__).parent
 
-VERSION = "1.46.2.dev20250712"  # PEP-440
+VERSION = "1.46.2.dev20250714"  # PEP-440
 
 # IMPORTANT: We should try very hard *not* to add dependencies to Streamlit.
 # And if you do add one, make the required version as general as possible:

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/config.py

@@ -710,7 +710,7 @@ _create_option(
 
         Allowed values:
         - "auto"     : Streamlit will attempt to use the watchdog module, and
-                       falls back to polling if watchdog is not available.
+                       falls back to polling if watchdog isn't available.
         - "watchdog" : Force Streamlit to use the watchdog module.
         - "poll"     : Force Streamlit to always use polling.
         - "none"     : Streamlit will not watch files.
@@ -750,8 +750,8 @@ def _server_headless() -> bool:
 _create_option(
     "server.showEmailPrompt",
     description="""
-        Whether to show a terminal prompt for the user to enter their email
-        address when they run Streamlit for the first time. If you set
+        Whether to show a terminal prompt for the user's email address when
+        they run Streamlit (locally) for the first time. If you set
         `server.headless=True`, Streamlit will not show this prompt.
     """,
     default_val=True,
@@ -1229,11 +1229,12 @@ _create_theme_options(
     "baseFontSize",
     categories=["theme"],
     description="""
-        Sets the root font size (in pixels) for the app.
+        The root font size (in pixels) for the app.
 
-        This determines the overall scale of text and UI elements.
+        This determines the overall scale of text and UI elements. This is a
+        positive integer.
 
-        When unset, the font size will be 16px.
+        If this isn't set, the font size will be 16px.
     """,
     type_=int,
 )
@@ -1242,12 +1243,12 @@ _create_theme_options(
     "baseFontWeight",
     categories=["theme"],
     description="""
-        Sets the root font weight for the app.
+        The root font weight for the app.
 
-        This determines the overall weight of text and UI elements.
-        Valid values are 100-600, in increments of 100.
+        This determines the overall weight of text and UI elements. This is an
+        integer multiple of 100. Values can be between 100 and 600, inclusive.
 
-        When unset, the font weight will be set to normal 400.
+        If this isn't set, the font weight will be set to 400 (normal weight).
     """,
     type_=int,
 )
@@ -1266,7 +1267,7 @@ _create_theme_options(
         - A comma-separated list of these (as a single string) to specify
           fallbacks
 
-        If no heading font is set, Streamlit uses `theme.font` for headings.
+        If this isn't set, Streamlit uses `theme.font` for headings.
     """,
 )
 
@@ -1274,24 +1275,31 @@ _create_theme_options(
     "headingFontSizes",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        Sets the font weight for h1-h6 headings. Valid values are in pixels or rem.
+        One or more font sizes for h1-h6 headings.
 
-        When unset, the font weights will be set to defaults:
-        - h1: 2.75rem (1.5rem for sidebar)
-        - h2: 2.25rem (1.25rem for sidebar)
-        - h3: 1.75rem (1.125rem for sidebar)
-        - h4: 1.5rem (1rem for sidebar)
-        - h5: 1.25rem (0.875rem for sidebar)
-        - h6: 1rem (0.75rem for sidebar)
-
-        For example, you can use the following to set the font sizes for h1-h6:
-            headingFontSizes = ["3rem", "2.875rem", "2.75rem", "2.5rem", "2.25rem", "2rem"]
+        If no sizes are set, Streamlit will use the default sizes for h1-h6
+        headings. Heading font sizes set in [theme] are not inherited by
+        [theme.sidebar]. The following sizes are used by default:
+        [
+            "2.75rem", # h1 (1.5rem for sidebar)
+            "2.25rem", # h2 (1.25rem for sidebar)
+            "1.75rem", # h3 (1.125rem for sidebar)
+            "1.5rem",  # h4 (1rem for sidebar)
+            "1.25rem", # h5 (0.875rem for sidebar)
+            "1rem",    # h6 (0.75rem for sidebar)
+        ]
 
-        If you only want to set h1-h3:
+        If you specify an array with fewer than six sizes, the unspecified
+        heading sizes will be the default values. For example, you can use the
+        following array to set the font sizes for h1-h3 headings while keeping
+        h4-h6 headings at their default sizes:
             headingFontSizes = ["3rem", "2.875rem", "2.75rem"]
 
-        Setting a single value will set the font size for all h1-h6 headings to that value:
+        Setting a single value (not in an array) will set the font size for all
+        h1-h6 headings to that value:
             headingFontSizes = "2.75rem"
+
+        Font sizes can be specified in pixels or rem, but rem is recommended.
     """,
 )
 
@@ -1299,20 +1307,29 @@ _create_theme_options(
     "headingFontWeights",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        Sets the font weight for h1-h6 headings. Valid values are 100-900, in increments of 100.
+        One or more font weights for h1-h6 headings.
 
-        When unset, the font weights will be set to defaults:
-        - h1: bold 700
-        - h2-h6: semi-bold 600
-
-        For example, you can use the following to set the font weight for h1 to 700 and h2-h6 to 600:
-            headingFontWeights = [700, 600, 600, 600, 600, 600]
+        If no weights are set, Streamlit will use the default weights for h1-h6
+        headings. Heading font weights set in [theme] are not inherited by
+        [theme.sidebar]. The following weights are used by default:
+        [
+            700, # h1 (bold)
+            600, # h2 (semi-bold)
+            600, # h3 (semi-bold)
+            600, # h4 (semi-bold)
+            600, # h5 (semi-bold)
+            600, # h6 (semi-bold)
+        ]
 
-        If you only want to set h1-h3:
-            headingFontWeights = [700, 600, 500]
+        If you specify an array with fewer than six weights, the unspecified
+        heading weights will be the default values. For example, you can use
+        the following array to set the font weights for h1-h2 headings while
+        keeping h3-h6 headings at their default weights:
+            headingFontWeights = [800, 700]
 
-        Setting a single value will set the font weight for all h1-h6 headings to that value:
-            headingFontWeights = 700
+        Setting a single value (not in an array) will set the font weight for
+        all h1-h6 headings to that value:
+            headingFontWeights = 500
     """,
 )
 
@@ -1336,12 +1353,12 @@ _create_theme_options(
     "codeFontSize",
     categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
-        Sets the font size (in pixels or rem) for code blocks and code text.
+        The font size (in pixels or rem) for code blocks and code text.
 
-        This applies to code blocks (ex: `st.code`), as well as font in `st.json` and `st.help`.
-        It does not apply to inline code, which is set by default to 0.75em.
+        This applies to font in code blocks, `st.json`, and `st.help`. It
+        doesn't apply to inline code, which is set by default to 0.75em.
 
-        When unset, the code font size will be 0.875rem.
+        If this isn't set, the code font size will be 0.875rem.
     """,
 )
 
@@ -1351,10 +1368,11 @@ _create_theme_options(
     description="""
         The font weight for code blocks and code text.
 
-        This applies to inline code, code blocks (ex: `st.code`), and font in `st.json` and `st.help`.
-        Valid values are 100-900, in increments of 100.
+        This applies to font in inline code, code blocks, `st.json`, and
+        `st.help`. This is an integer multiple of 100. Values can be between
+        100 and 900, inclusive.
 
-        When unset, the default code font weight will be 400.
+        If this isn't set, the code font weight will be 400 (normal weight).
     """,
     type_=int,
 )
@@ -1395,7 +1413,7 @@ _create_theme_options(
         For example, you can use "10px", "0.5rem", or "2rem". To follow best
         practices, use rem instead of pixels when specifying a numeric size.
 
-        If no button radius is set, Streamlit uses `theme.baseRadius` instead.
+        If this isn't set, Streamlit uses `theme.baseRadius` instead.
     """,
 )
 
@@ -1413,8 +1431,7 @@ _create_theme_options(
     description="""
         The color of the border around dataframes and tables.
 
-        If no dataframe border color is set, Streamlit uses `theme.borderColor`
-        instead.
+        If this isn't set, Streamlit uses `theme.borderColor` instead.
     """,
 )
 
@@ -1424,8 +1441,11 @@ _create_theme_options(
     description="""
         The background color of the dataframe's header.
 
-        If no dataframe header background color is set, Streamlit uses a mix of
-        `theme.bgColor` and `theme.secondaryBg`.
+        This color applies to all non-interior cells of the dataframe. This
+        includes the header row, the row-selection column (if present), and
+        the bottom row of data editors with a dynamic number of rows. If this
+        isn't set, Streamlit uses a mix of `theme.backgroundColor` and
+        `theme.secondaryBackgroundColor`.
     """,
 )
 
@@ -1453,11 +1473,17 @@ _create_theme_options(
     "chartCategoricalColors",
     categories=["theme"],
     description="""
-        An array of colors to use for categorical charts.
+        An array of colors to use for categorical chart data.
 
-        If no chart categorical colors are set, Streamlit uses a default set of
-        colors.
-        For light themes the default colors are:
+        This is a list of one or more color strings which are applied in order
+        to categorical data. These colors apply to Plotly, Altair, and
+        Vega-Lite charts.
+
+        Invalid colors are skipped, and colors repeat cyclically if there are
+        more categories than colors. If no chart categorical colors are set,
+        Streamlit uses a default set of colors.
+
+        For light themes, the following colors are the default:
         [
             "#0068c9", # blue80
             "#83c9ff", # blue40
@@ -1470,7 +1496,7 @@ _create_theme_options(
             "#6d3fc0", # purple80
             "#d5dae5", # gray40
         ]
-        For dark themes the default colors are:
+        For dark themes, the following colors are the default:
         [
             "#83c9ff", # blue40
             "#0068c9", # blue80
@@ -1490,11 +1516,15 @@ _create_theme_options(
     "chartSequentialColors",
     categories=["theme"],
     description="""
-        An array of 10 colors to use for sequential charts.
+        An array of ten colors to use for sequential or continuous chart data.
 
-        If no chart sequential colors are set (or less than 10 colors provided),
-        Streamlit uses a default set of colors.
-        For light themes the default colors are:
+        The ten colors create a gradient color scale. These colors apply to
+        Plotly, Altair, and Vega-Lite charts.
+
+        Invalid color strings are skipped. If there are not exactly ten
+        valid colors specified, Streamlit uses a default set of colors.
+
+         For light themes, the following colors are the default:
         [
             "#e4f5ff", #blue10
             "#c7ebff", #blue20
@@ -1507,7 +1537,7 @@ _create_theme_options(
             "#0054a3", #blue90
             "#004280", #blue100
         ]
-        For dark themes the default colors are:
+        For dark themes, the following colors are the default:
         [
             "#004280", #blue100
             "#0054a3", #blue90

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/code.py

@@ -69,11 +69,15 @@ class CodeMixin:
             An optional boolean indicating whether to wrap lines. This defaults
             to ``False``.
 
-        height : "content" or int
+        height : "content", "stretch", or int
             The height of the code block element. This can be one of the following:
 
             - ``"content"`` (default): The height of the element matches the
               height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
             - An integer specifying the height in pixels: The element has a
               fixed height. If the content is larger than the specified
               height, scrolling is enabled.

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/deck_gl_json_chart.py

@@ -330,6 +330,14 @@ class PydeckMixin:
         made available by Carto or Mapbox. The use of Carto or Mapbox is governed by
         their respective Terms of Use.
 
+        .. note::
+            Pydeck uses two WebGL contexts per chart, and different browsers
+            have different limits on the number of WebGL contexts per page.
+            If you exceed this limit, the oldest contexts will be dropped to
+            make room for the new ones. To avoid this limitation in most
+            browsers, don't display more than eight Pydeck charts on a single
+            page.
+
         Parameters
         ----------
         pydeck_obj : pydeck.Deck or None

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/form.py

@@ -144,11 +144,15 @@ class FormMixin:
               the parent container, the width of the container matches the width
               of the parent container.
 
-        height : "content" or int
+        height : "content", "stretch", or int
             The height of the form container. This can be one of the following:
 
             - ``"content"`` (default): The height of the container matches the
               height of its content.
+            - ``"stretch"``: The height of the container matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the container is not in a parent container, the height
+              of the container matches the height of its content.
             - An integer specifying the height in pixels: The container has a
               fixed height. If the content is larger than the specified
               height, scrolling is enabled.

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/html.py

@@ -77,10 +77,17 @@ class HtmlMixin:
             to the event container instead of the main container to avoid
             taking up space in the app.
 
-        width : int or "stretch" or "content"
-            The width of the HTML element. Can be an integer (pixels),
-            "stretch" (default) to use the full width of the container, or "content"
-            to size based on the content.
+        width : "stretch", "content", or int
+            The width of the HTML element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
         Example
         -------

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/lib/column_types.py

@@ -178,7 +178,7 @@ class ColumnConfig(TypedDict, total=False):
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -283,7 +283,7 @@ def Column(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -388,7 +388,7 @@ def NumberColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -465,6 +465,10 @@ def NumberColumn(
         integers. Setting ``step`` for float columns will ensure a consistent
         number of digits after the decimal are displayed.
 
+        If ``format`` is a predefined format like ``"dollar"``, ``step``
+        overrides the display precision. If ``format`` is a printf-style format
+        string, ``step`` will not change the display precision.
+
     Examples
     --------
     >>> import pandas as pd
@@ -547,7 +551,7 @@ def TextColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -670,7 +674,7 @@ def LinkColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -720,7 +724,7 @@ def LinkColumn(
 
         - ``None`` (default) to display the URL itself.
         - A string that is displayed in every cell, e.g. ``"Open link"``.
-        - A material icon displayed in every cell, e.g. ``":material/open_in_new:"``
+        - A Material icon that is displayed in every cell, e.g. ``":material/open_in_new:"``.
         - A JS-flavored regular expression (detected by usage of parentheses)
           to extract a part of the URL via a capture group. For example, use
           ``"https://(.*?)\.example\.com"`` to extract the display text
@@ -829,7 +833,7 @@ def CheckboxColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -938,7 +942,7 @@ def SelectboxColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1062,7 +1066,7 @@ def BarChartColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1159,7 +1163,7 @@ def LineChartColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1257,7 +1261,7 @@ def AreaChartColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1361,7 +1365,7 @@ def ImageColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1444,7 +1448,7 @@ def ListColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1538,7 +1542,7 @@ def DatetimeColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1701,7 +1705,7 @@ def TimeColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -1855,7 +1859,7 @@ def DateColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -2007,7 +2011,7 @@ def ProgressColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If
@@ -2137,7 +2141,7 @@ def JsonColumn(
         - ``"small"``: 75px wide
         - ``"medium"``: 200px wide
         - ``"large"``: 400px wide
-        - An integer specifying the width in pixels.
+        - An integer specifying the width in pixels
 
     help: str or None
         A tooltip that gets displayed when hovering over the column label. If

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/metric.py

@@ -135,11 +135,14 @@ class MetricMixin:
             The height of the metric element. This can be one of the following:
 
             - ``"content"`` (default): The height of the element matches the
-              height of its content, but doesn't exceed the height of the
-              parent container.
-            - ``"stretch"``: The height of the element matches the height of the
-              parent container.
-            - An integer specifying the height in pixels.
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
 
         width : "stretch", "content", or int
             The width of the metric element. This can be one of the following:

{streamlit_nightly-1.46.2.dev20250712 → streamlit_nightly-1.46.2.dev20250714}/streamlit/elements/plotly_chart.py

@@ -339,6 +339,17 @@ class PlotlyMixin:
             The Plotly ``Figure`` or ``Data`` object to render. See
             https://plot.ly/python/ for examples of graph descriptions.
 
+            .. note::
+                If your chart contains more than 1000 data points, Plotly will
+                use a WebGL renderer to display the chart. Different browsers
+                have different limits on the number of WebGL contexts per page.
+                If you have multiple WebGL contexts on a page, you may need to
+                switch to SVG rendering mode. You can do this by setting
+                ``render_mode="svg"`` within the figure. For example, the
+                following code defines a Plotly Express line chart that will
+                render in SVG mode when passed to ``st.plotly_chart``:
+                ``px.line(df, x="x", y="y", render_mode="svg")``.
+
         use_container_width : bool
             Whether to override the figure's native width with the width of
             the parent container. If ``use_container_width`` is ``True`` (default),
@@ -352,6 +363,11 @@ class PlotlyMixin:
             Streamlit uses its own design default. If ``theme`` is ``None``,
             Streamlit falls back to the default behavior of the library.
 
+            The ``"streamlit"`` theme can be partially customized through the
+            configuration options ``theme.chartCategoricalColors`` and
+            ``theme.chartSequentialColors``. Font configuration options are
+            also applied.
+
         key : str
             An optional string to use for giving this element a stable
             identity. If ``key`` is ``None`` (default), this element's identity
@@ -394,7 +410,12 @@ class PlotlyMixin:
             All selections modes are activated by default.
 
         **kwargs
-            Any argument accepted by Plotly's ``plot()`` function.
+            Additional arguments accepted by Plotly's ``plot()`` function.
+
+            This supports ``config``, a dictionary of Plotly configuration
+            options. For more information about Plotly configuration options,
+            see Plotly's documentation on `Configuration in Python
+            <https://plotly.com/python/configuration-options/>`_.
 
         Returns
         -------
@@ -405,11 +426,12 @@ class PlotlyMixin:
             attribute notation. The attributes are described by the
             ``PlotlyState`` dictionary schema.
 
-        Example
-        -------
-        The example below comes straight from the examples at
-        https://plot.ly/python. Note that ``plotly.figure_factory`` requires
-        ``scipy`` to run.
+        Examples
+        --------
+        **Example 1: Basic Plotly Chart**
+
+        The example below comes from the examples at https://plot.ly/python.
+        Note that ``plotly.figure_factory`` requires ``scipy`` to run.
 
         >>> import streamlit as st
         >>> import numpy as np
@@ -436,6 +458,31 @@ class PlotlyMixin:
            https://doc-plotly-chart.streamlit.app/
            height: 550px
 
+        **Example 2: Plotly Chart with configuration**
+
+        By default, Plotly charts have scroll zoom enabled. If you have a
+        longer page and want to avoid conflicts between page scrolling and
+        zooming, you can use Plotly's configuration options to disable scroll
+        zoom. In the following example, scroll zoom is disabled, but the zoom
+        buttons are still enabled in the modebar.
+
+        >>> import streamlit as st
+        >>> import plotly.graph_objects as go
+        >>>
+        >>> fig = go.Figure()
+        >>> fig.add_trace(
+        ...     go.Scatter(
+        ...         x=[1, 2, 3, 4, 5],
+        ...         y=[1, 3, 2, 5, 4]
+        ...     )
+        ... )
+        >>>
+        >>> st.plotly_chart(fig, config = {'scrollZoom': False})
+
+        .. output::
+           https://doc-plotly-chart-config.streamlit.app/
+           height: 550px
+
         """
         import plotly.io
         import plotly.tools