Collection Fields | SP Page Builder (Pro) - Documentation | JoomShaper
SP Page Builder 6 is Here! Learn More →

SP Page Builder (Pro)

Updated Last: 23 September 2025

Collection Fields

Collection fields define the structure of your Dynamic Content in SP Page Builder. Each field type can be configured allowing you to tailor the data entry process to your specific needs.

Common Field Settings

Each field includes the following configurable options:

  • Field Name – A clear, descriptive label for the field.
  • Help Text – Instructions or additional context.
  • Placeholder – A default hint inside input fields.
  • Required – Ensures the field must be filled before saving.

Basic Fields

These essential fields are automatically included in every collection item and help structure your content:

  • Title – The main name of the entry.
  • Alias – A URL-friendly version of the title for clean URLs.

These cannot be removed as they are crucial for content organization and accessibility.

Custom Fields

Custom fields allow you to add specific data types tailored to your content.

Text Field

For short text inputs (e.g., names, tags).

  • Max Character Limit – Set a restriction on text length.
  • Enable Text Area – Choose between a single-line or multi-line input.

Content Field

For adding rich text with formatting options.

  • Min/Max Character Limit – Control content length.

Image Field

For uploading and displaying images.

  • Upload Option – Allows users to upload images directly.

For creating and displaying image galleries. It supports all file types that are compatible with SP Page Builder Media Manager.

  • Name - Give a name to your gallery.
  • Help Text - The text entered here will appear as a tooltip next to your gallery Name.
  • Min Item Limit - Define the minimum number of image items that must be added to the gallery.
  • Max Item Limit - Define the maximum number of image items that can be added to the gallery.

Email Field

For storing email addresses.

Phone Field

For storing phone numbers.

Date/Time Field

For selecting dates and timestamps.

  • Show Time – Enable to include time selection.

Number Field

For numerical values (e.g., prices, counts).

  • Number Format – Choose integer or decimal.
  • Min/Max Limit – Define constraints.
  • Allow Negative Numbers – Enable if necessary.

For storing and displaying web addresses.

Switch Field

For adding an on/off toggle option.

  • Default State – Set the initial state to on or off.

Video Field

For embedding and displaying videos. Upload your video file in .mp4 or .mov formats, or simply add links from YouTube or Vimeo.

  • Name - Give a name to your video.
  • Help Text - The text entered here will appear as a tooltip next to your video Name.

File Field

For adding and downloading files.

  • Name - Give a name to your File.
  • Help Text - The text entered here will appear as a tooltip next to your file Name.
  • Extension - choose the format of the extension which you wish to upload as a file.

Note: In order to make your files downloadable, set the text field source to File Field and enable the “Download” option from the General settings.

Option Field

For selecting from predefined options.

  • Define Options – Set up selectable values.
  • Default Selection – Choose an initial value.

Reference Fields

These fields establish relationships between Collections, enabling dynamic content connections.

Reference Field (One-to-One Relationship)

Links a single item from another collection.

  • Best for: Connecting one-to-one relationships (e.g., linking an Author to a Blog Post).

Multi-Reference Field (One-to-Many Relationship)

Links multiple items from another collection.

  • Best for: Connecting one-to-many relationships (e.g., linking multiple Sessions to an Event).

Learn more about Collection References.

In the next section, discover how to add and manage Collection Items within your collections.