Skip to main content
Spaces are the foundation of your Campus community. They represent organizations, institutions, or communities where members can collaborate and share content.

​
Creating a New Space

1

Navigate to Space Creation

Go to /spaces/create or click the “Create Space” button from the Spaces page.
2

Enter Basic Information

Fill in the required fields:
  • Name: The display name of your space (2-100 characters)
    • Example: “Instituto Federal de São Paulo”
  • Slug: A URL-friendly identifier (2-100 characters, lowercase letters, numbers, and hyphens only)
    • Example: ifsp
    • This will be used in the URL: /spaces/ifsp
    • The slug auto-generates from the name, but you can customize it
  • Description (optional): A brief description of your space (up to 1000 characters)
    • Helps members understand the purpose of the space
3

Upload a Space Avatar (Optional)

Add visual identity to your space:
  • Click the avatar upload area
  • Select an image file (PNG, JPG, or GIF)
  • Maximum file size: 5MB
  • The image will be displayed as a circular avatar
You can remove and change the avatar before submitting.
4

Create the Space

Click the “Create Space” button to submit the form.Upon successful creation:
  • The space will be created with you as the owner
  • A space membership record is automatically created with the owner role
  • By default, spaces are public (visible to all users)

​
Space Configuration

After creating a space, you can manage its settings from the space management page (/spaces/[id]/manage).

​
Updating Space Details

Space owners can update the following properties: 
// Available update fields
{
  name: string,           // Space display name
  slug: string,           // URL identifier
  description: string,    // Space description
  avatar: File,          // Space avatar image
  isPublic: boolean      // Visibility setting
}

​
Managing Space Visibility

  • Public spaces: Visible to all users, anyone can discover and join
  • Private spaces: Only visible to members, require invitation or approval to join
To toggle visibility, update the isPublic field through the space settings.

​
Space Roles

Spaces support a hierarchical permission system:
RolePermissions
OwnerFull control over the space, can manage all settings, members, and content
ModeratorCan moderate content, manage members, but cannot delete the space
MemberCan view and participate in space activities

​
Best Practices

Select a short, descriptive slug that’s easy to remember and share. Once users start using your space URL, changing the slug can break bookmarks.
Help potential members understand what your space is about. Include:
  • The purpose of the space
  • Who should join
  • What type of content or activities to expect
Use a high-quality logo or image that represents your organization. This helps with:
  • Brand recognition
  • Professional appearance
  • Easy identification in lists
Before inviting many members, consider:
  • What groups you’ll create (if using the groups feature)
  • What types of content you’ll allow
  • Who will help moderate the space

​
Common Issues

Slug Already TakenIf you receive an error that the slug is already in use, try:
  • Adding your institution’s location or type
  • Using abbreviations
  • Adding numbers or descriptive terms
Example: ifsp → ifsp-saopaulo or ifsp-campus
Avatar Upload FailsEnsure your image:
  • Is under 5MB in size
  • Is in PNG, JPG, or GIF format
  • Has read permissions on your system
If issues persist, try compressing the image or converting to a different format.

​
Next Steps

After creating your space:

Invite Members

Add members and assign roles to build your community

Organize Events

Create events to engage your space members

Share Materials

Upload educational content and resources

Set Up Moderation

Configure moderation settings to maintain community standards

Build docs developers (and LLMs) love

Get started for freeTalk to us