> ## Documentation Index
> Fetch the complete documentation index at: https://docs.softr.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Dynamic App Logo
By default your app shows one logo to everyone. With **Dynamic logo** you can instead pull the logo from a field in your data, so each logged-in user sees a logo that belongs to them such as their own company's branding in a client portal, or their department's mark in an internal tool. It's also useful for co-branded apps or tools!
You configure it in **Settings → General**, in the **Logo** section.
## Before you start
Dynamic logo reads images out of your data, so you need two things in place first.
Upload a **Horizontal** and, if you use it, a **Square** logo in the Logo section. This is what users see when no image is found for them, so it is worth setting even when most users have their own. See [General Settings](/application-settings/general-settings) for the rest of this panel.
Add an image field to the table your logos live in and fill it in. In [Softr Databases](/softr-databases/field-types) this is a **File** field; in [Airtable](/data-sources/airtable) it is an attachment field. In other data sources it may be an attachment or file field of a similar nature.
Softr recommends logo images at least **400px** in height, in **SVG** or **PNG**. Keep the horizontal (banner) and square (icon) versions as separate fields — the app uses whichever shape a given surface calls for.
## Turn on Dynamic logo
In Studio, open **Settings** from the left toolbar, then **General**. Scroll to the **Logo** section.
Turn on the **Dynamic logo** toggle at the bottom of the section. A **Configure** button appears below it, marked with a dot to show it still needs setting up.
This opens the **Configure dynamic logo** dialog, where you point Softr at the fields holding your logos.
## Map your logo fields
The **Configure dynamic logo** dialog asks where the logos are stored. Work through it top to bottom — each choice narrows the next.
Pick the data source holding your logos. Every data source connected to your workspace is listed, and **Add another data source** at the bottom lets you connect a new one without leaving the dialog.
Choose the database or base within that account.
Choose the table. This should be the table your app's users come from, so that Softr can match the logged-in user to a row.
Choose the field storing the wide, banner-shaped logo. Image fields appear under **Suggested**; everything else is under **Other fields**. Use the search box if the table has many fields.
Choose the field storing the square, icon-shaped logo. You can leave this as **None** if you only use the horizontal logo.
Click **Save** to close the dialog, then **Save** again at the bottom of the General settings panel. [Publish your app](/publishing/publishing-your-softr-app) for the change to reach your live users.
Both field dropdowns include a **None** option, so you can map only one shape and let the other fall back to your default logo.
## What users see
Softr looks up the logged-in user's row and uses the image in the mapped field. The logo appears wherever your app logo normally does — the [navigation menu](/application-settings/navigation-settings), the login page, and the [footer](/application-settings/footer-settings).
**If no image is found for a user, they see the default app logo** you uploaded in the Logo section. That covers users whose logo field is empty, and users who have no matching row at all — so the app never renders without a logo.
The login page is shown *before* anyone signs in, so there is no user to look up yet. Expect the default logo there, and treat the dynamic logo as something users see once they are inside the app. If you need branded log in or sign up pages, try creating separate Utility pages for those with unique URLs for each client or company.
## Choosing where to store the logos
Which table you point at depends on how your data is shaped.
The simplest setup, and the one to reach for first. Add the image field directly to your users table and fill it in per user. Point the dialog at that table and map the field. This works well when logos are genuinely per-person, or when your user list is short enough that repeating a company logo across a handful of rows costs nothing.
In a client portal you usually store the logo once on a Companies table and link users to it. You don't need to duplicate that image onto every user — use a [Lookup](/softr-databases/related-record-lookup-and-rollup-fields) field to pull it through.
Add a File field to your Companies table and upload each client's logo once there.
Make sure each user record has a Related Record field linked to the right company.
Create a **Lookup** field, set **Lookup source** to your linked record field, and set **Field to look up** to the company's logo field. The image now resolves on each user's row.
In the Configure dynamic logo dialog, pick your users table and select the Lookup field as the horizontal or square logo.
Update a company's logo once and every user linked to it picks up the change — no per-user edits, and no workflow to keep copies in sync.
Map the **Lookup** field, not the linked record field itself. A linked record field can be selected in the dropdown but holds no image, so users would fall back to the default logo.
If a Lookup renders empty even though the company has a logo, check the company record itself rather than the Lookup. Re-linking the user to a freshly created company record is the quickest way to confirm the lookup is configured correctly.
## Keep the logo from disappearing
If your logos live in a Softr Databases **File** field, check the field's **Expiring file links** setting.
When that setting is on, Softr hands out links that stop working after a set period, customizable anywhere from 1 hour to 168 hours (7 days). That is useful for private documents, but a logo is meant to be public and permanent. Open the field, switch **Expiring file links** off, and your logo URLs will keep resolving.
It's also helpful to turn off the **multiple files** option here, since Softr will only use the first file in the field. Storing more than one can become confusing if the wrong one is being show in the app.
## Troubleshooting
Softr falls back to the default whenever it cannot find an image for the user. Check that the mapped field actually holds an image on that user's row, that you picked the table your users come from, and that you saved both the dialog and the General settings panel and then published.
This is the signature of expiring file links. Turn that setting off on the File field holding your logos.
Those users' rows are missing an image, or they have no row in the mapped table. Users added manually rather than [synced from your data source](/add-and-manage-users/syncing-users-with-a-data-source) are a common cause, since they may not exist in the table you mapped. If you are using a Lookup field, check that the affected users are linked to a company at all, and that the company record has a logo. Users linked to the same company should all resolve identically. If one company's users are the only ones failing, the problem is that company record, not your configuration.
Some surfaces only use the horizontal version. Check which one the surface is set to show — [Navigation settings](/application-settings/navigation-settings) and [Footer settings](/application-settings/footer-settings) each let you pick between the banner and square versions of your logo.
## Related
The rest of the app settings panel, including favicon and Softr branding.
Choose which version of your logo the navigation bar shows.
Choose which version of your logo the footer shows.
Colors, fonts, and the rest of your app's branding.