---
title: What are best practices for setting up the Document Center?
description: document center, best practices
---

[Skip to content](https://help.hoastart.com/what-should-i#main-content)

[![HOA Start](https://help.hoastart.com/hubfs/hoa-start-logo-v2.svg)](https://hoastart.com/)

Open main navigation

Close main navigation

 How can we help you?

- There are no suggestions because the search field is empty.

1. [HOA Start - Classic](https://help.hoastart.com/?hsLang=en)
2. [Documents](https://help.hoastart.com/documents?hsLang=en)

# What are best practices for setting up the Document Center?

### Considerations to Remember in the Document Repository

*Also searched as: file storage, document uploads, file permissions, document management*

The Document Repository gives you a convenient, customizable way to share — and restrict access to — community files, from covenants to meeting minutes. You can upload just about anything here, but it helps to understand how some aspects work under the hood.

### Duplicate Filenames

*(also: file naming, cloud storage filenames, broken document links)*

- Documents are stored in a cloud-based file system, which internally uses long sequences of letters and numbers as filenames.
- Unlike on your own computer, this means you **can** store more than one file with the same name in the same Document Repository folder.
- This also explains why editing a file linked from a text-based widget on your website — and then uploading a revised copy with the same filename — breaks the link. The link points to the previous version, which is stored under a different internal name in the cloud.
- Locally you always see the filenames you expect, but the system (which stores millions of files) needs more complex names behind the scenes.

### File Previews

*(also: previewable file types, document preview, PDF preview)*

You can preview certain file types directly in the Document Repository — and on a Documents-templated website page — without downloading them:

- GIF
- JPEG
- PNG
- PDF

**Exception:** If you link to a PDF file within a text-based widget on a website page, you **won't** get a preview — the file will download instead.

- Animated GIFs uploaded to the Document Repository **will** preview with animation, and you can use the Image tool (in the toolbar above the edit window on any text-based widget) to add the animation to a website page. 
    - Animated GIFs do **not** animate if added to a regular photo/image widget instead.
- If a visitor's browser is configured to preview PDFs, the file will both preview in the browser **and** download.
- Common file types that **cannot** preview include Microsoft Word, Excel, and PowerPoint files — these use proprietary formats the Document Repository can't render.

### File Uploads

*(also: upload size limit, storage limits, large file uploads)*

- You have **unlimited total storage space** for your Document Repository and other site content.
- However, **the size limit for any individual document is 15 MB.**
- Because of this limit, video recordings (e.g., board meetings) generally won't fit and also won't play natively on your website. 
    - Best practice: upload videos to a video service (YouTube, Vimeo, etc.) and embed them on your site using the **"Embed media from external sites"** tool, available in the toolbar above the edit window on a text-based website page widget in Site Setup.
    - Most video services let you make a video unlisted, so only people with the direct link can view it.

### File-Permission Setups and Changes

*(also: access permissions, folder restrictions, member-only files, admin-only files)*

You can set access permissions for both folders and individual files.

**Key rule:** A folder can be *less* restrictive than the files inside it, but never *more* restrictive.

- A publicly accessible folder **can** contain files that are Members-only, tag-restricted, or Admin-only.
- A Members-only (or tag-restricted) folder **cannot** contain a file marked as publicly accessible.

### In short:

- The container (folder) must be the **least restrictive** element.
- The contents (files) can be equally or **more restrictive**.

 

### Examples

| Folder access | File access inside |
| --- | --- |
| Public | Mix of public, Members-only, and tag-restricted files |
| Members-only | Mix of Members-only, tag-restricted, and Admin-only files |
| Public | All files public |
| Admin-only | All files Admin-only |

 

### Changing Existing Permissions

Because the system won't let a folder become more restrictive than its contents, you must change permissions in the correct order:

1. Change the **file** privileges first.
2. Then change the **folder** privileges.
3. Change permissions on the innermost files.
4. Change permissions on the folder containing them.
5. Repeat for each level moving outward (subfolder files, then subfolder, and so on).

For nested folders (folder \> subfolder \> sub-subfolder), start with the files in the **innermost** folder and work outward:

If you skip a file or subfolder, the system will show a warning the next time you try to make a change.

- [Website & Site Setup](https://help.hoastart.com/website-site-setup?hsLang=en#main-content)

    - [Site Builder & Settings](https://help.hoastart.com/website-site-setup?hsLang=en#site-builder-settings)
    - [Pages](https://help.hoastart.com/website-site-setup?hsLang=en#pages)
    - [Widgets & Site Elements](https://help.hoastart.com/website-site-setup?hsLang=en#widgets-site-elements)
    - [Images & Media](https://help.hoastart.com/website-site-setup?hsLang=en#images-media)
    - [Sponsors & Menu](https://help.hoastart.com/website-site-setup?hsLang=en#sponsors-menu)
- [Members](https://help.hoastart.com/members?hsLang=en#main-content)

    - [Households](https://help.hoastart.com/members?hsLang=en#households)
    - [Member Profiles & Data](https://help.hoastart.com/members?hsLang=en#member-profiles-data)
    - [Addresses](https://help.hoastart.com/members?hsLang=en#addresses)
    - [Dashboards & Reports](https://help.hoastart.com/members?hsLang=en#dashboards-reports)
    - [Registration](https://help.hoastart.com/members?hsLang=en#registration)
- [Roles & Permissions](https://help.hoastart.com/roles-permissions?hsLang=en)
- [Email & Communication](https://help.hoastart.com/email-communication?hsLang=en#main-content)

    - [Message Center (Overview & History)](https://help.hoastart.com/email-communication?hsLang=en#message-center-overview-history)
    - [Message Center Templates](https://help.hoastart.com/email-communication?hsLang=en#message-center-templates)
    - [E-mail Blasts](https://help.hoastart.com/email-communication?hsLang=en#e-mail-blasts)
    - [Professional Email Accounts](https://help.hoastart.com/email-communication?hsLang=en#professional-email-accounts)
- [Community Engagement](https://help.hoastart.com/community-engagement?hsLang=en#main-content)

    - [Messaging](https://help.hoastart.com/community-engagement?hsLang=en#messaging)
    - [Newsfeed & Posts](https://help.hoastart.com/community-engagement?hsLang=en#newsfeed-posts)
    - [Calendars](https://help.hoastart.com/community-engagement?hsLang=en#calendars)
    - [Events](https://help.hoastart.com/community-engagement?hsLang=en#events)
    - [Committees](https://help.hoastart.com/community-engagement?hsLang=en#committees)
- [Ticketing System](https://help.hoastart.com/ticketing-system?hsLang=en)
- [Violations & Compliance](https://help.hoastart.com/violations-compliance?hsLang=en)
- [Documents](https://help.hoastart.com/documents?hsLang=en)
- [Amenities & Reservations](https://help.hoastart.com/amenities-reservations?hsLang=en)
- [Boardroom & Meetings](https://help.hoastart.com/boardroom-meetings?hsLang=en)
- [Voting & Surveys](https://help.hoastart.com/voting-surveys?hsLang=en)
- [Mobile App](https://help.hoastart.com/mobile-app?hsLang=en)
- [Budgets & Expenses](https://help.hoastart.com/budgets-expenses?hsLang=en#main-content)

    - [Transactions & Reconciliations](https://help.hoastart.com/budgets-expenses?hsLang=en#transactions-reconciliations)
    - [Chart of Accounts](https://help.hoastart.com/budgets-expenses?hsLang=en#chart-of-accounts)
    - [Budgets](https://help.hoastart.com/budgets-expenses?hsLang=en#budgets)
    - [Vendors](https://help.hoastart.com/budgets-expenses?hsLang=en#vendors)
    - [Reports & Settings](https://help.hoastart.com/budgets-expenses?hsLang=en#reports-settings)
- [Invoicing & Billing](https://help.hoastart.com/invoicing-billing?hsLang=en#main-content)

    - [Dues & Fees](https://help.hoastart.com/invoicing-billing?hsLang=en#dues-fees)
    - [One-Time Charges](https://help.hoastart.com/invoicing-billing?hsLang=en#one-time-charges)
    - [One-Off Invoices](https://help.hoastart.com/invoicing-billing?hsLang=en#one-off-invoices)
    - [AR Dashboard](https://help.hoastart.com/invoicing-billing?hsLang=en#ar-dashboard)
- [Payments](https://help.hoastart.com/payments?hsLang=en#main-content)

    - [Wallets](https://help.hoastart.com/payments?hsLang=en#wallets)
    - [Stripe & ACH Setup](https://help.hoastart.com/payments?hsLang=en#stripe-ach-setup)
- [Balance and Credit](https://help.hoastart.com/balance-and-credit?hsLang=en)
- [QuickBooks & Accounting Integrations](https://help.hoastart.com/quickbooks-accounting-integrations?hsLang=en)
- [Support](https://help.hoastart.com/support?hsLang=en)

[![HOA Start](https://help.hoastart.com/hubfs/hoa-start-logo-v2.svg "HOA Start")](https://hoastart.com/)

<https://www.facebook.com/HOA-Start-Website-Software-113801303503776/> <https://twitter.com/hoawebsitesoft> <https://www.linkedin.com/company/hoa-start>

Copyright © 2026, HOA Start