Engage users through an ideas portal

An ideas portal encourages in-app engagement with your visitors as part of a two-way exchange of ideas for continuous product discovery and development, structured around your business vision and strategy.

Create and share one or more ideas portals to:

• Share and validate product ideas by encouraging users to vote and comment on the ideas that you present in your ideas portal.
• Gather additional feedback to analyze alongside other feedback sources in Listen.

Benefits

Externally, providing a portal that your visitors can interact with in-app promotes transparency. Communicate openly with your users by sharing your ideas and encouraging them to interact with the content by voting, commenting, and submitting feedback. Exposing the ideas you're considering and inviting further feedback builds trust and satisfaction.

Internally, gathering evidence through ideas presented in your portal gives Product teams confidence in their next steps, using structured, qualitative data to inform their product decisions. Use the customizable features of the portal to present ideas that are organized around your company's vision and strategy. For more information, see Customize your ideas portal.

Permissions

To create, edit, and share an ideas portal, you must have Listen Manager permissions.

• To share an ideas portal through a guide, you must additionally have Guide Publisher permissions.
• To share an ideas portal by adding it as a module to a Resource Center and then publishing that Resource Center, you must additionally have Resource Center Author and Resource Center Publisher permissions.

An admin user has all of the above permissions by default. A Pendo admin user can also update a user's permissions in Settings > Users to give them the permissions needed to share portals. For more information, see Roles and permissions.

Setup process

You can have multiple portals, which you can share from one or more locations, including Resource Centers, guides, and your own application. For this reason, sharing a portal with your visitors is a two-step process:

1. Create an ideas portal. 
2. Provide access to the portal. 

You can allow your visitors access to one or more portals through:

• A module in your Resource Center. This is the most flexible way of sharing multiple portals with multiple segments of visitors.
• A guide. Sharing a portal through a web-based guide involves embedding the portal into your guide. Sharing a portal through a mobile guide involves adding a button to your guide.
• A link or button in your application. Your visitors can access a full-screen view of an ideas portal through a link or button that you add to your application.

Sharing a portal through a Resource Center or a guide allows you to share the portal with a specific segment of visitors that you define.

Create an ideas portal

To create an ideas portal in Pendo:

1. Go to Listen > Portals. This page lists any existing portals that have already been created.
2. Select Create portal.
3. Give your portal a meaningful name. This isn't the name that your visitors see.
   
   
4. Select Create and then Edit.
5. Customize your portal.
6. Preview your portal using the toggle at the top of the page to see what your portal will look like to your visitors.
7. Select the down arrow next to Save and then Save and exit.

Your portal is now in the Portals page in Listen, alongside any other portals that might have been created. The next step is to share your portal.

Share through a module in your Resource Center

You can allow your visitors to access a portal that you created through a module in your Resource Center.

You can only have one Resource Center for each application. You can provide access to portals that are relevant to specific applications by creating different portals and adding them as modules to different Resource Centers.

At its simplest level, you can allow your visitors to access one portal in one Resource Center, but you can also add one portal to multiple Resource Centers or multiple portals to one Resource Center, each targeted at its own segment of visitors.

You can control who can access a portal using segmentation when you add the portal module. If you have more than one portal module in the same Resource Center, you can ensure that your visitors only see one portal based on their segment.

You can add the portal to a Resource Center from the portal's settings or from the Resource Center that you want to publish it in. You must have at least one portal and one Resource Center already created. For information on creating Resource Center, see Overview of the Resource Center.

Publish from the Portal's settings

To add your portal to a Resource Center from the details of the portal in Listen:

1. Go to Listen > Portals.
2. Hover over the portal and select Edit portal or select Settings at the bottom of the card.
3. Select Share in the top-right corner of the page. This opens a window with the Resource Center tab open by default.
4. Choose your Resource Center from the dropdown menu.
5. Select + Add module. This opens the details of the portal module in the Resource Center you added it to. 
6. Edit the Segment as required. For information about segments, see Segments.
7. Select Manage In App to preview the portal from the Resource Center.
8. Select Back to Resource Center to manage the publication status of the Resource Center.

Your changes then appear as part of the Resource Center Draft. You must publish these changes for visitors to see them in the Resource Center. For more information, see Overview of the Resource Center.

Publish from the Resource Center

To add your portal to a Resource Center from the Resource Center itself:

1. Go to Guides > Resource Center.
2. Find and open the Resource Center that you'd like to add a portal to. This takes you to the default Settings tab for the Resource Center.
3. Hover over the first card in the preview and then select + Add module.
4. Hover over Listen visitor portal and then select Select Module.
5. Select Add modules. This takes you back to the default Settings tab for the Resource Center.
6. Find and hover over the Listen Visitor Portal card in the preview, and then select View Module Details.
7. Choose a portal from the dropdown menu.
8. Edit the Segment as required. For information about segments, see Segments.
9. Select Save.
10. Select Manage In App to preview the portal from the Resource Center.

Your changes then appear as part of the Resource Center Draft. You must publish these changes for visitors to see them in the Resource Center. For more information, see Overview of the Resource Center.

Share through a guide

You can grant access to your ideas portal through a guide, which you can target to different segments of visitors. You can also create multiple guides, one for each portal you create. You can control access to different idea portals using segmentation in each of your guides.

You can add the same portal to multiple guides, but if you want to share multiple portals, you must create multiple guides, one for each portal.

Embed in a web-based guide

You can embed your ideas portal to a web-based guide, which you can target to different segments of visitors. When a visitor opens an ideas portal through a web-based guide, the portal opens inside the guide.

To embed your portal inside a web-based guide, you must first copy the embed code to use in a guide.

1. Go to Listen > Portals.
2. Hover over the portal and select Edit portal or select Settings at the bottom of the card.
3. Select Share in the top-right corner of the page.
4. Open the Guide tab.
5. Select Copy code.

Then, while creating or editing a web-based guide:

1. Add a code block.
2. Paste the code into the HTML tab.
3. Optionally, edit the height of the guide. The default height is 70% of the screen, which you can change by editing height: 70vh important;. For example, if you wanted the guide to take up 100% of the screen, you could update the code to height: 100vh important;. You might then also want to edit the width, which you can do as standard from the Edit Container > Styling tab in the Visual Design Studio.
4. Select Done.

You then need to edit the guide's details as required and publish the guide. You can control access to different idea portals using segmentation in each of your web-based guides. For more information, see Define guide settings.

Link from a mobile guide

You can grant access to your ideas portal through a button in a mobile guide, which you can target to different segments of visitors. When a visitor opens an ideas portal through a mobile guide, the portal opens in a web browser on the mobile device.

To link to a portal from your mobile guide: 

1. While creating or editing a mobile guide, add a button and name it.
2. Choose Launch Listen Portal from the Actions dropdown menu.
3. In the Select portal submenu that appears, choose the portal that you'd like to connect to the button.

You then need to edit the guide's details as required and publish the guide. You can control access to different idea portals using segmentation in each of your mobile guides. For more information, see Segment and schedule a guide in Create a guide for mobile.

Share through your application

You can embed the portal into your application using a unique code block that you add to your application code. To get the code block:

1. Go to Listen > Portals.
2. Hover over the portal and select Edit portal or select Settings at the bottom of the card.
3. Select Share in the top-right corner of the page.
4. Open the Embed in app tab.
5. Select Copy code.

View who has access to your portals

To see what portals are being shared through which Resource Centers and guides:

1. Go to Listen > Portals.
2. Hover over the portal and select Edit portal or select Settings at the bottom of the card.
3. Check the Sharing section at the bottom of page, which shows a table of the following information:
   • Name. The title of the portal.
   • Type. Where the portal is added (Resource Center or guide).
   • App. The application that the portal is added to.
   • Status. Whether the portal is public.

Edit your portal

To edit your portal, go to Listen > Portals, hover over the portal, and select Edit portal. For guidance, see Customize your ideas portal. Any changes you make and save automatically update the portal where ever you have chosen to share it.

If your portal is in a Resource Center, you can also edit the portal from the Resource Center itself:

1. Go to Guides > Resource Center.
2. Find and hover over the portal module in your Resource Center.
3. Select View Module Details.
4. Select Manage portal.
5. Select Edit portal.