Key Takeaways
•
Group pins into themed collections with custom name, color, and icon.
•
A single pin can belong to multiple collections at once for maximum flexibility.
•
Share collections with other users in collaborative or view-only mode.
Collections in Peel The Map let you group your pins into themed lists, just like creating playlists for your music. Whether it's "Summer in Japan", "Best Cafes", or "Hiking Trails", each collection helps you keep your places organized by theme, trip, or purpose.
1. What Are Collections
A collection is a group of pins with a name, color, and icon representing it. Unlike tags (which are categories applied to individual pins), collections are containers that can include any pin regardless of its tags. Collections are stored in Firestore as a subcollection of each user: users/{userId}/collections.
2. Creating a Collection
From the Collections screen, tap the "+" button to open the creation modal. Choose a descriptive name, a distinctive color, and an icon that captures the essence of the collection. The new collection will appear immediately in the grid, ready to be populated with your pins.
3. Adding and Removing Pins
You can add pins to a collection directly from the pin details or from the collection screen. A pin can belong to multiple collections at the same time, giving you the flexibility to organize your places in different ways without duplicating them.
4. Organizing with Multiple Collections
Create collections for each trip, activity type, or any criteria you like. You can sort collections by name or creation date, and quickly search them with the built-in search bar.
5. Collaborative and Shared Collections
Collections can be collaborative (isCollaborative), allowing other users to add and remove pins, or shared (isShared) for view-only access. Metadata (name, color, icon) is replicated in the shared_collections subcollection of the user you share with, optimizing reads.
6. Premium Features and Limits
The number of collections you can create depends on your subscription tier. Guest and free users have a maximum limit, while premium users can create unlimited collections. Data for unauthenticated users is saved locally on AsyncStorage.
FAQ
Can I share a collection with other users?
Yes, you can create collaborative collections (isCollaborative) for editing together with other users, or shared collections (isShared) for view-only access.
What's the difference between a tag and a collection?
Tags are visual categories applied to individual pins (e.g. #Restaurant), while collections group multiple pins into a themed list (e.g. 'Restaurants in Tokyo'). A pin can have multiple tags and belong to multiple collections.