FAQ & Troubleshooting

Common Questions

Can I use the same attribute in multiple modules?

Yes! Attributes are shared across all modules. Create an attribute once and use it in as many modules as you need. Use section-level overrides to customize the attribute name, description, or placeholder for each module.

How do I change an attribute name in just one module?

Use attribute overrides:

1. Go to the module's Editor tab
2. Select the section containing the attribute
3. Click on the attribute
4. In the right panel, enter custom Name, Description, or Placeholder
5. Save changes

This only affects how the attribute appears in this module.

Can I delete a module?

Yes, but be careful:

1. Go to Admin → Modules
2. Click the three-dot menu on the module
3. Select Delete
4. Confirm deletion

Warning: This permanently deletes the module and all its entries. This action cannot be undone.

How do I make my module visible to users?

1. Ensure the module is Active (not Draft) in Settings
2. Add the module to your navigation (Admin → Design → Navigation)
3. Set appropriate access permissions in the Settings tab
4. Verify package permissions allow users to read the module

Can users create entries in my module?

Only if:

1. The module is Active
2. Users have Write permissions in the Settings → Access section
3. Their package includes Write access to Custom Modules
4. The module is accessible via navigation or a view

How do I import existing data?

Use the CSV import feature:

1. Go to Content tab
2. Click "+ Entry" → "Import Data"
3. Download the template CSV
4. Fill in your data following the template format
5. Upload the completed CSV
6. Review and confirm the import

Can I export my module configuration?

Module duplication effectively exports configuration:

1. Duplicate the module
2. The duplicate includes all configuration
3. You can then modify or use it as a template

For data export, use the Export feature in the Content tab.

How do I restrict entries by location?

Use the Address attribute with restrictions:

1. Add an Address attribute to your module
2. Go to Settings → Restrictions
3. Add address-based restrictions
4. Select allowed cities, states, or countries
5. Save restrictions

Can I have multiple forms on one entry?

Yes! Add multiple form interactions:

• In the Header section (one form)
• In other sections (multiple forms)

Each form can collect different information and have different settings.

How do I connect form submissions to a pipeline?

1. Ensure your pipeline allows content from other modules
2. View the entry with submissions
3. Click the Pipeline icon in the top right
4. Select "Connect to Pipeline"
5. Choose the pipeline
6. Submissions appear as pipeline cards

What's the difference between Labels and Attributes?

Labels:

• Simple tags for categorization
• Can only be assigned by platform admins
• Shared across all modules
• Used for filtering and restrictions
• Displayed as colored chips
• Quick to add/remove

Attributes:

• Structured data fields
• Can be complex (dates, files, addresses)
• Defined in module structure
• Collected during entry creation
• Used for detailed information

Can I change the module URL after creation?

Yes, but be careful:

1. Edit the module settings
2. Change the URL field
3. Save changes

Warning: This breaks existing links to the module. Update your navigation and any external links.

How do I make entries appear in the platform feed?

1. Edit module settings
2. Enable "Display in Feed"
3. Save changes

New entries will now appear in the platform feed alongside other content.

Can I use Custom Modules with Groups?

Yes! Enable group connections:

1. Edit module settings
2. Enable "Enable Group Connections"
3. Save changes

Entries can now be associated with specific groups.

---

Troubleshooting

Entries are not appearing in my module

Check:

1. Module Status: Is the module Active (not Draft)?
2. Access Permissions: Do you have Read access?
3. Restrictions: Are restrictions hiding the entries?
4. Filters: Clear all filters to see all entries
5. User Package: Does your package allow access?

I can't create entries

Check:

1. Write Permissions: Do you have Write access in Settings → Access?
2. Package Permissions: Does your package allow Write access?
3. Module Status: Is the module Active?
4. Navigation: Is the module accessible from navigation?

Attributes are not showing in my section

Check:

1. Attribute Added: Did you add the attribute to the section?
2. Section Saved: Did you save the section after adding the attribute?
3. Attribute Order: Is the attribute ordered correctly?
4. Package Permissions: Does the section allow your package to view it?

Form submissions are not appearing

Check:

1. Form Connected: Is the form properly connected to the interaction?
2. Submission Successful: Did the user receive a confirmation?
3. Pipeline Connection: If connected to pipeline, check the pipeline
4. Permissions: Do you have access to view submissions?

RSS import is not working

Check:

1. Valid URL: Is the RSS feed URL correct and accessible?
2. Feed Format: Does the feed follow RSS standards?
3. Import Settings: Are field mappings configured correctly?
4. Permissions: Do you have permission to create RSS imports?
5. Feed Content: Does the feed contain items?

Images are not displaying correctly

Check:

1. Image Format: Use supported formats (JPG, PNG, WebP)
2. File Size: Ensure images are within size limits
3. Image Variant: Try different variants (Contain, Cover, Blur)
4. Upload Success: Verify the image uploaded successfully
5. Browser Cache: Clear cache and reload

Map view is not showing entries

Check:

1. Address Attribute: Do entries have address data?
2. Map Enabled: Is Map view enabled in Layout settings?
3. Geocoding: Are addresses properly geocoded?
4. Map Configuration: Is the correct address attribute selected?

Filters are not working

Check:

1. Filters Enabled: Are filters enabled in Settings → Filters?
2. Attribute Data: Do entries have data for the filtered attribute?
3. Filter Configuration: Are filter options configured correctly?
4. Cache: Clear browser cache and reload

Export is not including all data

Check:

1. Column Visibility: Are all desired columns visible?
2. Filters Applied: Clear filters to export all entries
3. Permissions: Do you have access to all entries?
4. Export Settings: Verify export parameters

---

Best Practices

Module Design

Keep it Simple: Start with essential fields and add more as needed

Logical Sections: Group related fields together in sections

Clear Labels: Use descriptive names for attributes and sections

Required Fields: Only mark truly essential fields as required

Help Text: Add descriptions to guide users

Attribute Management

Reuse Attributes: Use existing attributes instead of creating duplicates

Consistent Naming: Use clear, consistent names across modules

Appropriate Types: Choose the right attribute type for your data

Validation: Set appropriate validation rules

Defaults: Provide sensible default values where applicable

Layout Optimization

Card Design: Include the most important information on cards

View Selection: Enable views that match how users will browse

Image Quality: Use high-quality images with appropriate dimensions

Mobile Friendly: Test layouts on mobile devices

Performance: Limit the number of elements on cards for better performance

Access Control

Principle of Least Privilege: Give users only the access they need

Package-Based: Use packages for broad access control

Restrictions: Use restrictions for fine-grained control

Regular Review: Periodically review and update permissions

Test Access: Test with different user roles to verify access

Content Management

Consistent Data: Encourage consistent data entry

Regular Cleanup: Remove outdated or duplicate entries

Moderation: Monitor and moderate content as needed

Backups: Regularly export data for backup

Documentation: Document your module structure for future reference

Performance

Optimize Images: Compress images before uploading

Limit Attributes: Don't add unnecessary attributes to cards

Use Restrictions: Reduce the number of visible entries with restrictions

Pagination: Use pagination for large datasets

Caching: Leverage browser caching for better performance

User Experience

Clear Navigation: Make modules easy to find

Intuitive Forms: Design forms that are easy to complete

Helpful Errors: Provide clear error messages

Feedback: Give users confirmation after actions

Search & Filter: Make it easy to find specific entries

---

Glossary

Attribute: A field type that defines what kind of data can be entered (text, date, file, etc.)

Entity: An individual item or entry within a module (also called "Entry")

Form Template: A reusable form definition with questions that can be attached to entries

Interaction: A button on an entry that triggers an action (form submission or external link)

Label: A tag used to categorize and filter entries

Label Group: A collection of related labels

Module: A container that defines the structure and settings for a type of content

RSS Import: Automatic import of content from an RSS feed

Section: A group of related fields within an entry

Restriction: A rule that limits which entries are visible to users

View: A way of displaying entries (card, list, map, table, feed, kanban)

---

Last updated: March 6, 2026