Skip to main content

How to add meta tags to a Streamlit app


  • Streamlit is a cool Python library to build GUIs for python based web-apps
  • It doesn’t support the feature to provide custom meta-tags for the apps you make and instead always have the default streamlit-tags instead
  • The following steps is based on deploying a streamlit app bundled as a docker which you can deploy in your VPS.

Workaround tl;dr

  • Replace the default index file used by streamlit with our custom file containing meta tags of our own


  • Ensure docker/docker-compose is installed on your VPS


  1. Create an index.html in the src directory with similar contents:
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8" />
    <link rel="shortcut icon" href="./favicon.png" />
    <title>Your Site Name</title>
      window.prerenderReady = !1;
    <!-- changes to be made here -->
    <script defer="defer" src="./static/js/main.dccfd6b5.js"></script>
    <link href="./static/css/main.f4a8738f.css" rel="stylesheet" />
    <!-- changes to be made above this -->
    <meta name="title" content="Custom Title" />

    <noscript>You need to enable JavaScript to run this app.</noscript>
    <div id="root"></div>

Feel free to add in more meta tags of your choice.

  1. Update your dockerfile to have a line like the following:
FROM python:3.9


COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# important line for adding custom metatags
COPY src/index.html /usr/local/lib/python3.9/site-packages/streamlit/static/index.html
# ensure that the above line is present in your dockerfile

COPY . .

CMD ["streamlit", "run", "", "--server.headless", "true", "--server.fileWatcherType", "none", "--browser.gatherUsageStats=False"]

Basically we’re copying the index file to replace the streamlit default index.html inside the docker container.

  1. Start the container. eg: docker-compose up You’ll notice that what you get is just a white screen in the streamlit app endpoint. This is because the javascript is not loaded yet.
  2. Find the pid of the container(docker ps) and exec into it to run bash
docker exec -it <pid> bash

This basically lets you go inside the running container and inspect it using bash. Replace the PID with the PID of your container

  1. Go to the path /usr/local/lib/python3.9/site-packages/streamlit/static/static/js inside the interactive bash shell inside container. Note that the python3.9 may be different in your case. In that case, just let cd + tab autocomplete the path for you based on the python version you have installed.

  2. Now do an ls like the following:

ls main*.js
  1. Copy the full filename of this file and replace it in the script tag of the index.html file we created earlier.
  2. Restart the container.(rebuild if necessary too).

This should let the javascript load correctly and have your project be loaded fine with custom meta tags.

If you note that somehow css seems to have broken, then just cd to /usr/local/lib/python3.9/site-packages/streamlit/static/static/css inside the container and do an ls like:

ls main.*.css

Once you identify the the main css file, replace main.f4a8738f.css in the index.html file with this one.

Essentially, we’re replacing the basic html file from streamlit with our custom file and then loading the streamlit libraries(js and css) from their path inside the docker container.

Alright, with these steps, you should easily be able to create a streamlit application with custom Meta-tags.

Bonus tip

Maybe you are already aware of this, but to get meta images freely hosted, just paste your images to site. Upload the image and then paste the url to the meta image tag as the following:

<meta property="og:image" content="<code>/image.png" />