> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/portals/building-a-portal/sections/share-your-files.md).

# Share your files

Let visitors send files of their own from your Portal, without adding them to your library.

Most of a Portal hands your assets to other people. This section runs the other way: a visitor drops files of their own onto the page and gets back a link, or an email, that carries them to whoever needs them.

It is the file-transfer corner of a Portal — for the artwork a partner is returning, the photographs an agency shot for you, the deck someone needs to pass on. Nothing sent this way joins your asset library.

## Add the section

1. In the builder, open the **Sections** panel and select **Add section**.
2. Choose **Share your files**, pick a variant, and select **Add section**.
3. Edit the headline and the copy around the drop zone as you would on any other section.

The variants differ only in how the drop zone sits beside the words:

| Variant | Layout                                                      |
| ------- | ----------------------------------------------------------- |
| **A**   | Headline and highlights beside a drag-and-drop upload zone. |
| **B**   | Centered headline above a drag-and-drop upload zone.        |
| **C**   | Boxed callout card with a compact drop zone.                |
| **D**   | Split layout with headline beside the drop zone.            |

## Set upload limits

By default a visitor can send any number of files, of any size. To cap that:

1. Select the section in the builder, then select **Adjust limits** in the toolbar above it.
2. Turn on **Set limitations** (*Control file count and size limits*).
3. Fill in either or both fields:

| Setting                  | What it limits                           |
| ------------------------ | ---------------------------------------- |
| **Max number of assets** | How many files one share can hold.       |
| **Max size per asset**   | The largest a single file can be, in MB. |

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FtNCxDz9zamEs0UtKjfQa%2Fimage.png?alt=media&amp;token=24f21913-8eab-448b-8c23-923ac8da59d7" alt=""><figcaption></figcaption></figure>

Both take whole numbers. Leave a field empty for no limit on that point, or turn **Set limitations** off to clear both. A value is saved when you leave the field or press Enter.

The **Share your files** widget in a Portal's widgets panel has the same two settings in its settings dialog.

## What a visitor does

The section shows a drop zone reading **Drag & drop, click to browse**. Dropping files on it, or picking them, opens **Share your files** — two steps, then a link.

### 1 — The files

The chosen files are listed with a running total, as *3 file(s) (12 MB)*. **Add more files** adds to the list, **Remove file** takes one out, and a file already in the list is marked **Already added** until **Dismiss** clears the notice. **Next** moves on.

When limits are set, the drop zone states them, for example *Up to 20 files · max 200 MB each*, and the total reads *3 of 20 file(s) (12 MB)*. A file over the size limit is left out with *"report.pdf" is larger than the 200 MB limit.*, and files past the count limit are left out with *You can share up to 20 files at once. 2 file(s) not added.* The rest of the same selection still uploads. When the count limit is reached, **Add more files** stops responding until a file is removed.

### 2 — The share

Give the share a **Title** — it is called **Shared files** if you leave it alone. **Add message** opens a **Message** that goes to the recipients. Then choose how to send it:

| Tab       | What it does                                                  |
| --------- | ------------------------------------------------------------- |
| **Email** | Add the recipients' addresses and select **Send**.            |
| **Link**  | Select **Generate link**, then **Copy link** once it appears. |

To protect the share with a password, turn on **Require password** and type one in the field that appears. Whoever opens the link then has to enter it before they see the files, on the same password page as any protected [share link](https://docs.scaleflex.com/portals/viewing-a-portal/share-links.md). Leaving the field empty stops the share with *Password is required*.

On the **Email** tab, a protected share also offers **Include password**. Tick it to put the password in the invitation; leave it clear to pass the password on yourself. It is off by default, and its tooltip says why: *Sharing a password via email is not considered secure — please only use it if you have no other means to contact your recipients*.

Last, choose how long the share should last under **Share expires**:

| Option           |
| ---------------- |
| **One day**      |
| **One week**     |
| **One month**    |
| **Three months** |

The password and the expiry are part of the share itself, so they lock once it has been created and cannot be changed by trying again.

With a link made, the dialog confirms *Your share link has been generated* and offers the link to copy. **Back** returns to the file list; **Done** closes it.

{% hint style="info" %}
There is no "never" among the expiry options, and that is deliberate. Files sent through this section are temporary: when the share expires, or you delete it, the files go with it.
{% endhint %}

## Visitors need an account

Sending files is tied to a person, so a visitor who is not signed in sees **Sign in to send files and share them with the team.** and a **Sign in** button where the drop zone would be. On a Portal that anyone can open, expect the section to ask for a sign-in before it does anything.

## Where the files go

They are uploaded to your project but kept out of your asset library: they do not appear in listings or search, they cannot be picked in a gallery, and they are not assets you curate or have to tidy up afterwards. They exist to be collected by whoever has the link, and then to expire.

That is the difference between this section and the rest of a Portal. Everything else shows assets you chose; this one carries files you never have to own.
