# How to Set Up a Social Media List

Let's set up a social media list!&#x20;

{% hint style="info" %}
This component is not available in legacy mobile or web apps.
{% endhint %}

First, drag the social media list component out from the "Lists" section of the components tab.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2Fo1UAwVNtye5SBu84nByo%2Fsocial-media-list-in-components-tab.png?alt=media&#x26;token=30b8cb06-bf23-42c2-90c4-a0ff5a6f680c" alt=""><figcaption></figcaption></figure>

Drag the component onto one of your screens. Now let's select a collection for this list to pull from.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2Fz5INrZUnITXmVwjxoMps%2Fblank-social-media-list.png?alt=media&#x26;token=bfb0e28e-fb93-40e3-9f68-fae6f6783cb7" alt=""><figcaption></figcaption></figure>

Now select any filtering or sorting you might need.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FAkDh0PTOGVFk2uWTi0PG%2Fsocial-media-list-filtering.png?alt=media&#x26;token=28cac844-a4ba-4323-a8ea-e14a610f45ca" alt=""><figcaption></figcaption></figure>

Toggle Advanced Options and enable "Load As User Scrolls" when working with posts with over 20 items.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FmaVpPUW4mMqis5L6TLzJ%2FScreenshot%202025-09-04%20at%202.12.57%E2%80%AFPM.png?alt=media&#x26;token=127f6503-73e1-4b88-bf00-255d061d901f" alt=""><figcaption></figcaption></figure>

I'm using a collection called "Posts". For reference, here's how I have the collection set up.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2F0sr96vyeW1NXp87BFO3z%2Fpost-collection-setup.png?alt=media&#x26;token=b6234a0e-5af6-48af-b78a-927e6b2e8ba8" alt=""><figcaption></figcaption></figure>

Next let's customize some of the styling. We can adjust the background color, border, and overall padding of the list items in the "Background" tab.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FLTx4VkurCANzImR1jPKZ%2Fbackground-settings.png?alt=media&#x26;token=a178d0d7-96f0-4162-88d8-29f86a6b5e3f" alt=""><figcaption></figcaption></figure>

Now let's start getting to the post content. The "Header" tab allows us to customize the header of each post. We can add a profile picture for the creator of each post by pulling data from our collection.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FPPep16mejyTng960XAug%2Fadd-profile-picture.png?alt=media&#x26;token=c33f3ea5-5665-41de-8c5c-16bec5d614fb" alt=""><figcaption></figcaption></figure>

We can add 3 lines of text next to the profile picture. First let's put the username of the person who created the post next to their profile picture.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FC0nrztBLd2rXJKyW5gd1%2Fadd-creator-username.png?alt=media&#x26;token=88c6c6ea-c46d-4bad-9fd2-2f0f62276586" alt=""><figcaption></figcaption></figure>

Now we have 2 more lines of text we can add underneath. We can add more information about the user, or other info, such as the post's creation date.

{% hint style="info" %}
None of these lines of text are required. Some or all of them can be left blank.
{% endhint %}

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FtR7GTmtngFQRmFvoE6bP%2Fadditional-header-text.png?alt=media&#x26;token=8d7024c8-3475-4ea7-a470-0540481ace75" alt=""><figcaption></figcaption></figure>

We can also add 2 optional icons to the right side of the header. Each icon has a toggle to enable or disable it, and menus to select the icon design and color. We can also attach a click action to the icon.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FMojVaBDBAgvp2ek6ucol%2Fheader-icon-options.png?alt=media&#x26;token=64780c8e-c443-444d-a92a-91af2f23fdb1" alt=""><figcaption></figcaption></figure>

Now let's move on to the main content. We have a text field and an image field for each post. Let's pull data from our collection to populate these.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FlPHNpyChbs8R9gscKRFK%2Fsocial-media-list-main-content.png?alt=media&#x26;token=546bfe80-d1c6-44c0-85af-5f254e28459d" alt=""><figcaption></figcaption></figure>

We also have some text fields below each post that we can use to show things like comments and reactions.

{% hint style="info" %}
The way I have likes set up in my database is as a relationship to users. That's why in this screenshot, the count of likes appears as "User count".
{% endhint %}

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FO63FYtJOJ8ngkyoslhgp%2Fbottom-text-examples.png?alt=media&#x26;token=dca9e6af-b6f8-44af-845d-59d6c39ee24c" alt=""><figcaption></figcaption></figure>

Below the text, we have some buttons we can customize. Each of the icon buttons in this section can either be set up as simple icons, or toggles that change color and design based on a condition. Let's set the first icon button as a toggle, and decide its state based on whether or not the Logged In User has liked the Current Post.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2Fn4ctKbUhWkoyXDef00SM%2Flike-button-toggle.png?alt=media&#x26;token=55339724-57f7-433b-a20a-3adcbb009ef5" alt=""><figcaption></figcaption></figure>

We can change the color and design of the icon based on the condition we just set. If the condition is true, it's considered "active". If the condition is false, it's considered "inactive". The way this one is set up, the button will show a filled-in, red heart if the Logged In User has liked the Current Post, or a hollow, gray heart if the Logged In User has not liked the Current Post.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FbaeOpy0V2AXLiwW2PQmH%2Flike-button-states.png?alt=media&#x26;token=b5718072-9547-497e-a5ff-e6176e99dfa3" alt=""><figcaption></figcaption></figure>

Clicking this toggle will change the condition we set at the top. In this example, if a user who has not liked the post clicks this button, the post will then be added to their "Liked Posts" relationship. If they click the button again, it will be removed from their liked posts.

We also have the option to run additional actions when an end user clicks on this button.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2Fky8BPrxUHKS7V5WR8JXf%2Flike-button-additional-actions.png?alt=media&#x26;token=229c1d77-b9aa-4214-9295-24e2cb05f6b2" alt=""><figcaption></figcaption></figure>

FInally, we have the option to add text next to this icon. Let's add the word "Like".

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2F6emvT7t3UmQpS8QBdYnm%2Flike-icon-text.png?alt=media&#x26;token=cdae8b5f-9375-4a55-bd31-1612544a2fb0" alt=""><figcaption></figcaption></figure>

Now let's set up the second icon button to have the "Icon" type. This is much simpler. We have options to select the design, color, text, and actions for this icon. Additionally, we can enable or disable this icon via the "Enable Left Icon 2" toggle.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2FEzZTTAQChbzMEQ2PPzTx%2Fcomment-icon-settings.png?alt=media&#x26;token=87bb7030-13af-450e-ab36-623988f47ec2" alt=""><figcaption></figcaption></figure>

The right icon has all the same settings as well.

Lastly, we can enable a bottom button for additional actions. This is turned off by default. Toggling "Enable Bottom Button" turns this on.

<figure><img src="https://3467607506-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LhGHkPsv15svPIU5I7C%2Fuploads%2F3gxlCQKwzQQ3Ah3EyG7v%2Fbottom-button-settings.png?alt=media&#x26;token=5710c191-8678-4faf-bd31-23b6de087d85" alt=""><figcaption></figcaption></figure>

This button is a bit simpler than the icon buttons. We can change the background color, add text, and set up actions.

Now our list is fully set up. Happy posting! :tada:
