Create your first portal

This guide walks you through the full setup of a portal from scratch: creating the portal, connecting your Notion workspace, setting up tabs, and adding users.

Step 1: Create your portal

After signing up, click Create a portal.

You will be asked to provide:

A portal name.
A subdomain (e.g. acme.portal.getslap.co).

Step 2: Create your first tab

A tab is a page that appears in your portal’s navigation menu. Each tab is connected to one Notion database - it defines what data your portal users can see and interact with.

To create your first tab, go to Admin > Tabs and click Add tab.

General settings

Name - the label shown in the portal menu (e.g. Tickets).
Slug - the URL path for this tab (e.g. my-tickets).
Data source - the Notion database connected to this tab.

If this is your first tab, you will need to connect your Notion workspace first. Click + Connect another data source to start the OAuth flow. This lets you choose which pages and databases SlapPortal can access.

Note: When sharing access in Notion, make sure to share the page that contains the database, not just a view of it.

Note: After sharing a new database, Notion can take a moment to update permissions. Wait a few seconds and refresh if the database doesn’t appear in the dropdown right away.

Display

Choose how records are displayed in the tab view:

List - a standard list of records.
Board - a kanban-style board.

Properties

This section controls which properties from your Notion database are visible in the portal and what users can do with them.

See the supported properties documentation for the full list and details on how each type behaves.

For each property, you can configure:

Order - drag the handle to reorder properties.
Tab view - toggle whether the property is visible in the tab view (list or board). A property must be visible in the page view to appear in the tab view.
Group by - use a property to group records in the tab view (e.g. group tickets by status).
Page view - set each property to hidden, visible, or editable in the record view.

Permissions

Comments - allow portal users to view and post comments on Notion pages. See for more details.
View page content - allow portal users to see the Notion page body.
Allow page creation - allow portal users to create new records in this database. When enabled, you can define default property values for new records (e.g. automatically set the client field to the logged-in user).

Access rules

Define which records a portal user can see. Three options are available:

No access - users cannot see any records.
Access to all records - users can see all records in the database.
Custom rules - set conditions that must be met for a record to be visible. For example: the client field must match the logged-in user, and the status must not be “Cancelled”.

For more details, see the Access rules documentation.

Step 3: Add users

Portal users are managed through a Notion database. That database must contain a property (title, email, or text type) that holds each user’s email address.

To set up users, go to Admin > Users:

Select the Notion database to use as your user source
Map the email property
Save your settings

From there, you have two sync options:

Auto-sync - any change to the Notion database (add, edit, delete) is automatically reflected in the portal
Manual sync - use the Sync button to trigger a sync at any time, or to force a resync

The user table shows all synced users, a link to their Notion page, and the date of their last login. For more details, see the users documentation.

Step 4: Customize your portal

Go to Admin > General to:

Update your portal name
Upload your logo