FAQs

Fast answers for publishing and building authenticated apps

Short answers about MiniUp sites, Functions, members and roles, MiniUp Tables, hosted datasets, ChatGPT app creation, and sharing.

Looking for step-by-step guides? Visit MiniUp Documentation β†’

Support or inquiries: miniup.help@gmail.com

What makes MiniUp different?
It combines frontend files, hosted data, login, and backend logic so you can build lightweight authenticated apps in one workspace.
Do I need hosting knowledge?
No. Paste HTML or upload a folder and publish.
What should I upload?
Single HTML for one page, folder or ZIP for assets. Learn more about publishing β†’
Can I make a page private?
Yes. Use Invite-only or Private access to require site membership before protected files load. Password access provides a separate password unlock flow.
Can I turn a table into an API?
Yes. Upload CSV or Excel and MiniUp creates a live API you can pair with the same project.
Can I add backend logic without a server project?
Yes. MiniUp's built-in signed-in defaults include one MiniUp Function and 1,000 production calls per month. Configured limits can differ; see Plans for current limits.
What is a data-powered microsite?
A published page that can also ship with live API or dataset links from the same workspace.
Can I publish Parquet?
Yes. Signed-in users can convert tabular or spatial files into Parquet or GeoParquet.
What is the Data Catalog?
It is one place to find and inspect MiniUp-hosted datasets you own across your sites.
What is a Dataset Bundle?
It is an approved group of datasets that can be used together for one app. Learn more about Dataset Bundles β†’
What are Data Sources?
They let signed-in users create refreshable MiniUp snapshots from supported web files and ArcGIS layers.
Can I turn a PDF into an app-ready asset?
Yes. Signed-in users can create PDF Knowledge Packs with stable endpoints and an App Prompt for coding AIs.
Do I need to sign in for the Data API?
Sign in to create and manage one. App and visitor access follows the table's access settings.
Can I edit after publishing?
Yes. Update files or records without changing the link.
Can I roll back page changes?
Yes. Signed-in users get revision history for page files, subject to account limits.
Can I show my page in Gallery?
Yes. Turn on Show in Gallery from the page editor when you want discovery.
Can I use my own domain?
Yes. Signed-in pages can connect a custom domain when custom domain access is enabled for the account.
Can I use MiniUp inside ChatGPT?
Yes. If the MiniUp app is available for your ChatGPT account, connect it from Settings β†’ Apps and publish with simple prompts.
Do datasets stay tied to the page?
Datasets keep their source-site relationship and access status, and the Data Catalog shows where each one belongs.

Publishing

Pick the right upload, then decide whether it stays on a MiniUp link, becomes a branded share surface, or grows into a data-powered microsite.

πŸš€
HTML, folder, or ZIP?
Choose the right upload.
Use HTML for a single file. Use Folder or ZIP when you have images, CSS, or JS.
⚑
How do I publish a site?
A simple path from upload to link.
Dashboard β†’ Pages β†’ New Page, then upload and click Publish.
πŸ”₯
What makes MiniUp different from a basic static host?
More than a one-link upload tool.
Basic static hosts stop at the URL. MiniUp lets the same workspace grow into a branded page, data-backed app, hosted dataset, map, PDF Pack, or ChatGPT-built experience that you can continue managing.
πŸ”—
Can I choose my link name?
Pick a short, clean URL.
Yes. Choose a name during publish and confirm the URL before going live.
🏷️
Can I connect a custom domain?
Use your own branded URL.
Yes. Signed-in accounts can connect custom domains to published pages when the feature is enabled for the account. Open Dashboard β†’ Pages β†’ Edit β†’ Custom Domain, add the hostname, then save.
🧭
Why does custom domain setup say pending?
Verification and DNS still need to finish.
Pending verification or pending configuration means MiniUp is still waiting for hostname verification or the required DNS records. Once the hostname points correctly, the status moves to Active.
πŸ”
Can I replace a site after publishing?
Update without changing the link.
Yes. Dashboard β†’ Pages β†’ Edit lets you upload new files while keeping the same URL.
πŸ•˜
Can I restore an older file version?
Signed-in pages include rollback points.
Yes. Signed-in users can open Dashboard β†’ Pages β†’ Edit β†’ Revision History to restore a saved snapshot. Revision history is not included for guest publishing, and the number of saved revisions per file follows your current account limits.
🌐
How do I show a page in Gallery?
Opt in from the page editor.
Open Dashboard β†’ Pages β†’ Edit, expand the Gallery card, then turn on Show in Gallery. You can add a title, thumbnail, and short description before saving so the page looks good in the public Gallery.
🧩
Do you host all assets?
Images, CSS, and JS.
Yes. All files in your folder or ZIP are served from the same link.

MiniUp Functions

Build real authenticated MiniUp apps without setting up a separate backend, or publish a standalone hosted API.

βš™οΈ
What is a MiniUp Function?
Server-side JavaScript for hosted APIs or authenticated apps.
A MiniUp Function is server-side JavaScript hosted by MiniUp. It can run as a standalone Public or API Key API at a stable functions.miniup.app endpoint, or link to one MiniUp site as a Site Members backend. Use it for authorization, business logic, private data access, or external API requests; frontend files stay in the MiniUp site.
πŸ“Š
What is included by default?
Clear limits for every signed-in account.
MiniUp's built-in signed-in defaults include one MiniUp Function and 1,000 production calls per month. Configured limits can differ; see Plans for current limits. MiniUp administrators can adjust account limits or disable Functions for an individual account.
πŸ§ͺ
Can I test before publishing?
Draft tests do not change the live endpoint.
Yes. Run an isolated draft test, review the response, and publish only when it is ready. Draft tests and CORS preflight requests do not count against the monthly production-call quota.
Ζ’
Can Functions remember data between requests?
Function state and identity
βŒ„
Yes. Function Memory stores persistent JSON through env.MINIUP_MEMORY. Shared memory belongs to a Function; env.MINIUP_MEMORY.caller isolates values by authenticated caller. Preview and production are separate, and both count toward storage limits. Read methods, quotas, and examples.
Ζ’
How do Function tenants and caller identities work?
Function state and identity
βŒ„
MiniUp derives env.MINIUP_CALLER from a verified API key, site member, or x402 payer. Caller memory automatically uses that identity. It does not create company tenants or share data across separate keys or members. Never trust a browser-supplied tenant ID as authorization. See tenant patterns and boundaries.
Ζ’
What happens when I rename, rotate, or revoke an API key?
Function state and identity
βŒ„
A Function supports up to 20 active named keys. Renaming changes the label. Rotation replaces the secret immediately while preserving caller identity and memory. Revocation stops authentication; audit history and caller memory are retained. A newly created key has a separate identity. Copy new secrets when shown; they cannot be viewed again.
Ζ’
Why does caller memory fail in the Test panel?
Function state and identity
βŒ„
Most previews have no authenticated caller. A Site Member owner preview has the owner’s caller identity in separate preview storage. Anonymous Public calls and free x402 routes also have no caller identity. Test API-key isolation with distinct keys against the published endpoint. Review identity and preview behavior.
Ζ’
Can I view data saved by users of my Function?
Owners can manage shared and caller memory.
βŒ„
Yes. Open your Function and select Memory to inspect production or preview data, search keys, filter callers, view JSON, and delete records with confirmation. Caller isolation separates callers from one another, while the Function owner can manage the stored data. API keys and ordinary site membership do not grant access to these owner controls. Read the management guide.
πŸ”
How do I protect a Function?
Choose Public, API Key, or Site Members access.
Public is callable without Function authentication. API Key is for trusted external or server-to-server callers. Site Members links the Function to one MiniUp site and uses that site's authenticated members and roles. Browser code on the linked site can call /api/functions/... without embedding a Function API key. Each protected Function route must still enforce its own authorization checks.
πŸ—οΈ
Can MiniUp build a real authenticated app?
Keep the frontend in your site and link a Site Function.
Yes. Keep HTML, CSS, JavaScript, and components in your MiniUp site: index.html, app.js, style.css, and components/*.js. Use a linked Site Function for backend logic. Invite-only or Private access can require membership before protected site files load. A Public page remains public even when its Site Members API requires authenticated membership. This fits lightweight internal tools, portals, dashboards, and customer/member experiences.
πŸ”—
What is a Site Members Function?
An authenticated backend linked to one MiniUp site.
It is a MiniUp Function in Site Members access mode, linked to one MiniUp site. MiniUp authenticates the site's member and securely passes their identity and role to the Function. Browser code on that site can call /api/functions/... without a Function API key. Create one from the site's Functions page.
πŸ‘€
How does a Function know who is signed in?
MiniUp supplies trusted identity to the Function.
Through env.MINIUP_USER, which contains id, email, name, role, and siteId. MiniUp supplies this authenticated context for a Site Members Function. The browser does not create this trusted identity, and browser-provided user or role values are not authorization proof.
🧩
Can different users see different parts of an app?
Use a bootstrap response to choose features.
Yes. The frontend can request a /bootstrap route from its Site Function and use the response to show or load features for owner, admin, editor, or viewer. Components remain normal site files. The frontend controls what users see. The Function controls what users are allowed to do: backend routes must enforce authorization independently, including when a user calls them directly.
πŸ‘₯
How do I add users or change their roles?
Manage members in Page Settings β†’ Access.
The site owner or an admin manages members in Page Settings β†’ Access. Invite users as Admin, Editor, or Viewer. Linked Site Functions receive the current owner, admin, editor, or viewer role. Member role changes are reflected without redeploying the Function.
πŸ›‘οΈ
Can a viewer manually call an admin API?
The Function must check the role and reject the action.
They can attempt the request. For an admin-only action, the Function should check env.MINIUP_USER.role, allow only owner or admin, and return 403 for a viewer. Hiding an Admin button or component alone is not security; every protected backend route must enforce authorization.
πŸ”‘
Where should private credentials go?
Use Function Secrets.
Store private credentials in Function Secrets, not browser JavaScript or public site source. Function Secrets let backend logic call protected services without exposing credentials to app users. Do not embed Function API keys or MiniUp Table write keys in frontend files.
πŸ—ƒοΈ
Where should private application data live?
Use MiniUp Tables or another protected service.
Keep small private JSON in caller-scoped Function Memory, and queryable application records in MiniUp Tables or another approved protected service accessed through the Function. Keep the data service's access controls in place, authorize each request, and return only the records and fields the signed-in user may access. Avoid storing private business data in frontend files; a Function provides backend logic and data access, not frontend storage.
πŸ”’
Can a Site Members Function be called from another MiniUp site?
It is linked to one site.
No. A Site Members Function is linked to one MiniUp site. Another site or an unsigned direct request cannot use it as that site's authenticated backend. Browser calls should use /api/functions/... on the linked site.
βš–οΈ
What is the difference between Public, API Key, and Site Members?
Choose the mode that fits your callers.
Public: Callable without Function authentication; useful for open APIs.
API Key: Requires a Function API key; suited to trusted external or server-to-server callers.
Site Members: Linked to one MiniUp site; uses its authenticated members and roles, with no Function API key in browser code.
πŸ“¦
Can a Function use server-side libraries?
Use Trusted ESM sources approved in MiniUp.
Yes. Trusted ESM lets a MiniUp Function import server-side libraries from approved sources shown in the Function editor. Use those libraries for backend logic; keep frontend HTML, CSS, JavaScript, and components in the MiniUp site.

MiniUp in ChatGPT

Use normal language prompts to turn uploaded files, pasted HTML, or approved hosted datasets into a real MiniUp app.

πŸ’¬
How do I connect MiniUp in ChatGPT?
Find it in ChatGPT's Apps area.
In ChatGPT, open Settings β†’ Apps, find MiniUp in the directory, and click Connect. If you use a managed workspace, an admin may need to enable the app first.
πŸͺ„
What should I say to publish something?
Keep the prompt simple.
A good default prompt is: β€œUse the uploaded file to build and publish a professional MiniUp app. If it is geospatial, make it a map app. If it is tabular, make it a dashboard. Publish it and show me the final URLs.”
πŸ“¦
Will the final page use MiniUp-hosted data?
That is the goal of the connected app flow.
Yes. The MiniUp ChatGPT app is meant to publish a real MiniUp site backed by MiniUp-hosted data instead of leaving you with a browser-local upload demo.
πŸ”Ž
Can ChatGPT build from data I already host on MiniUp?
Inspect eligible datasets before building.
Yes. ChatGPT can list and inspect eligible datasets from your MiniUp Data Catalog, including their fields, limited sample data, profile, and recommended uses, before creating an app.
🧺
Can ChatGPT build an app from multiple MiniUp datasets?
Use an approved Dataset Bundle.
Yes. Create or approve a Dataset Bundle to define which eligible datasets belong together and what role each one should play. MiniUp keeps the underlying access requirements in place.
βž•
How do I use MiniUp after I connect it?
Invoke it inside a chat.
Start a chat, then add MiniUp from the + menu and More, or use an @ mention if your ChatGPT interface shows the app that way.

Data API

Turn a table into a live API you can use in apps, microsites, and internal tools.

πŸ“Š
How do I create an API from a table?
Upload CSV or Excel.
Dashboard β†’ My API β†’ Create from Table, then upload a CSV or XLSX.
πŸͺ„
What is a data-powered microsite on MiniUp?
A page and data surface living together.
It is a published page paired with live API or dataset links from the same workspace, so the share link, docs, and data delivery all stay under one project.
πŸ“„
Where are the docs?
See examples you can copy.
Open My API β†’ View API Data to see auto-generated docs, copyable examples, and the OpenAPI file.
🧰
Can I control allowed methods?
Per table toggles.
Yes. Toggle GET, POST, PATCH, PUT, or DELETE per table in My API.
πŸ”‘
What is the write key for?
Protects write access.
It is one supported way to authorize record changes from a trusted app or workflow. Keep it private and rotate it if it is no longer trusted.
πŸ”
Can I rotate the write key?
Reset it with one click.
Yes. My API β†’ Rotate Key replaces it and disables the old key.

Parquet & GeoParquet

Convert larger tabular or spatial files into stable dataset links with copyable docs and browser-friendly previews.

🧱
Which files can I convert?
Tabular and spatial inputs.
Signed-in users can upload CSV, XLSX, XLS, JSON, GeoJSON, shapefile ZIP, Parquet, and GeoParquet files from the Parquet tab.
πŸ§ͺ
Do I get docs and examples?
Usage guidance, fields, and preview.
Yes. Each dataset includes practical usage guidance, field information, and a browser preview so you can understand it before connecting an app.
🧭
Can one project include a page, API, dataset, and PDF Pack?
Yes, that is one of the main MiniUp advantages.
Yes. Signed-in users can publish the page, create tables and APIs, attach Parquet or GeoParquet assets, and generate PDF Knowledge Packs under the same project and access model.
πŸ”
Can I protect a Parquet file?
Same access rules as the page.
Yes. Hosted datasets can follow their site's access or use another supported data access setting. Review the access badge in the Data Catalog before using the dataset in an app.

Data Sources, Data Catalog & Dataset Bundles

Bring supported data into MiniUp, understand what you already host, and approve the right datasets for each app.

πŸ”„
What can I do with Data Sources?
Create a stable hosted snapshot.
Signed-in users can connect a supported HTTP or HTTPS data file or ArcGIS REST layer from the dashboard, preview it, and create a refreshable MiniUp-hosted Parquet or GeoParquet snapshot.
πŸ—‚οΈ
What appears in the Data Catalog?
Your MiniUp-hosted datasets across sites.
The Data Catalog brings together the Table APIs, Parquet files, GeoParquet files, and supported map layers you own across MiniUp sites. You can search, filter, preview, and inspect them before deciding how to use them.
πŸ“‹
What can I inspect before building an app?
Understand the dataset before choosing visuals.
MiniUp can show field information, a limited sample, a lightweight profile, spatial details when available, access status, and recommended dashboard uses. This helps people and ChatGPT choose appropriate charts, maps, filters, and tables.
βœ…
Why should I use a Dataset Bundle?
Make multi-dataset app access explicit.
A Dataset Bundle records which datasets are approved for one app and how they should be used, such as primary records, map layers, boundaries, events, metrics, or reference data. It helps prevent accidental use of unrelated data.
πŸ›‘οΈ
Does a Dataset Bundle make protected data public?
No. Existing access requirements still apply.
No. Bundles help approve and describe datasets, but they do not remove the underlying access rules. MiniUp blocks public app creation when the selected data is not eligible for public use.

PDF Knowledge Packs

Convert manuals, policies, reports, workbooks, and specs into source-backed artifacts that browser apps and coding AIs can use.

πŸ“˜
What is a PDF Knowledge Pack?
A PDF converted into app-ready files.
It turns a PDF into app-ready content with source references and prompts. The App Prompt helps ChatGPT, Codex, Claude, or another coding AI create a useful experience grounded in the original document.
⬆️
How do I create one?
Upload a PDF or paste a PDF URL.
Sign in, open a site's PDF Packs tab, then upload a PDF, drag and drop it, paste a PDF URL, or convert an existing PDF file already attached to the site.
🧠
What does the App Prompt do?
It tells a coding AI how to build the app.
It gives a coding AI the context and source-reference guidance needed to create a complete, mobile-friendly app from the PDF Pack.
πŸ“
What are the default PDF limits?
Signed-in limits are shown on Plans.
The default signed-in limit is shown on the Plans page and on the PDF Packs screen before you upload.

Privacy & Security

Choose public or protected sharing based on the audience and the data involved.

πŸ”’
Can I password-protect a page?
Optional, per page.
Yes. Enable Password in Publish settings or Dashboard β†’ Pages β†’ Settings.
πŸ‘€
Is my page public?
Site Access controls who can open it.
With Public access, anyone with the link can view the page, even if a linked Site Members API requires authenticated membership. Invite-only and Private access can require membership before protected frontend files are served. Password access uses a password unlock flow. Gallery listing is separate from these access settings.
πŸ›‘οΈ
Can admins remove a page from Gallery?
Gallery stays moderated.
Yes. Gallery is moderated. Owners control whether they list a page, and admins can still hide or re-enable a listing when needed.
🧷
Can I restrict who writes to the API?
Write key required.
Yes. MiniUp supports controlled write access for Table APIs. Only trusted people, apps, or workflows should be allowed to change records.
πŸ›‘
Can I disable a page?
Take it offline quickly.
Yes. Dashboard β†’ Pages β†’ Disable unpublishes the link.
πŸ—ƒοΈ
How do access settings affect hosted datasets?
Data should match the intended audience.
MiniUp shows the access status of hosted datasets in the Data Catalog and checks compatibility before they are added to an app workflow. Use public data for open apps and protected options for data that should have a limited audience.
πŸ—‘οΈ
Can I delete a page or table?
Permanent removal.
Yes. Dashboard β†’ Pages or My API β†’ Delete removes it and its data.

Editing & Updates

Change content without changing the link.

✏️
Can I edit a published page?
Update content anytime.
Yes. Dashboard β†’ Pages β†’ Edit lets you replace HTML or upload new files.
🧾
Can I edit records in the table?
Inline table edits.
Yes. My API β†’ View API Data lets you edit rows inline.
πŸ“₯
Can I export data?
Download CSV.
Yes. In View API Data, click Export CSV.
🌍
Can I remove or replace a custom domain?
Update branding without republishing.
Yes. Open the Custom Domain panel on the page, change the hostname, or remove the domain entirely without rebuilding the page itself.
πŸ”—
Do updates change the URL?
Links stay stable.
No. Your page and API links stay the same.
πŸͺ„
Does replacing a Parquet file change the URL?
Stable dataset links.
No. Replacing a Parquet or GeoParquet dataset keeps the same published access URL so dashboards and scripts do not need a new link.
🧱
Can I update tables without an API call?
Use the dashboard.
Yes. Use the table editor in View API Data.

Limits & Reliability

Clear limits and steady links.

🧭
Why do fair-use limits exist?
Protects the service.
They prevent abuse and keep the service fast for everyone.
βœ…
Are published links stable?
Reliability basics.
Yes. Links stay the same unless you delete or disable them.
πŸ‘€
What are Guest limits?
Publishing only.
Guest is meant for simple publishing. For the current default limits, see the Plans page.
πŸ™Œ
What are Signed-in limits?
More room to ship.
Signed-in accounts include publishing, Gallery, Data API, Parquet / GeoParquet, PDF Knowledge Packs, and custom domains, subject to the current plan limits. See the Plans page for the latest defaults.
πŸ”
Do I need to sign in for the Data API?
API access requires an account.
Yes. Data API requires sign-in.
⏳
What happens if I hit a limit?
Calm, clear behavior.
You will see a clear limit message. You can retry later, reduce file size, or sign in for more room depending on the action.