Contentstack
Changelog

Star Ratings

Note: This documentation uses the legacy approach with extensions. We have launched Star Ratings as a Marketplace App. For more information on Star Ratings, please refer to the Star Ratings App Installation Guide.

Star Ratings custom field extension allows Contentstack users to provide a star-rating system as an input field in the content types of a stack. 

This step-by-step guide explains how to create a Star Ratings custom field extension for your content types:

  1. Add the “Star Ratings” custom field extension to your stack

    To add this extension to your stack, log in to your Contentstack account and perform the following steps:

    1. Go to your stack, and click on the “Settings” icon on the left navigation panel.
    2. Click on Extensions.
    3. Click on the + New Extensions button, and select the Use prebuilt option.
    4. In the following window, from the drop-down menu,  select Custom Field.
    5. Hover over Star Ratings, and click on + Add Extension. 

    6. In the Create New Extension page, you will see the following options:
      • Title (required): You will see a predefined title, “Star Ratings.” Use the same title to add the custom field in your content type.
      • Field data type (required): By default, the data type for the input data is set as “Number.”
      • Multiple (optional): Select this if your custom field accepts multiple values, and the data type is not JSON.
      • Hosting method (required): The hosting method is set to Hosted By Contentstack since it is a custom field hosted on Contentstack.
      • Extension Source Code (required): Here you will find the source code for the custom field. You can make changes to this code as per your requirements.
      • Config Parameters (optional): Provide values for the config parameters if you have used any in the source code.
    7. Finally, Save this custom field.

    After saving the custom field, let’s learn how to start using this custom field in your content type.

  2. Use your custom field

    To use this custom field in your content type, perform the following steps:

    1. Click on the “Content Models” icon on the left navigation panel and click the + New Content Type button.
    2. Create a content type by adding relevant details as displayed below:
    3. On the Content Type Builder page, add the Custom field to your content type by clicking on the “Insert a field” link denoted by a + sign and then clicking on Custom.
    4. Select Star Ratings from the Select Extension dropdown menu, and configure other properties of your custom field.

      Note: You can provide specific instance-level configuration settings for your Custom Field extension by referring to the Config parameters section.

    5. After adding other fields to your content type, click on either Save or Save and Close button. This will create a content type.

    6. To use this field, create an entry for this content type, and you will see this field on your entry page as shown below: