Skip to main content

UGC Media Grid

Showcase Instagram posts on your store to build trust and drive sales

Updated over a week ago

Available on the Free plan

The UGC Media Grid lets you display Instagram photos and videos directly on your store in a responsive, customizable grid. Whether it’s content you’ve posted or posts you’ve been tagged in, this widget brings real customer experiences to life.

How it looks

The UGC Media Grid typically includes these elements by default:

  • The "Made by us, Shared by you" header

  • A "Tag us to see your picture featured in our page" sub-title

  • 9 published posts fetched from your Instagram account

  • A Load more button at the bottom

How the UGC Media Grid works

Once you've connected your Instagram account and installed the UGC Media Grid:

  • We automatically fetch 100 of your most recent Instagram posts including:

  • The grid updates daily to pull in new posts.

  • You can choose which posts to publish.

  • The UGC Media Grid displays the first 9 approved posts by default, with a Load more button for customers to explore additional content.

  • Customers can click on a post to read the related reviews or buy the featured product — turning social proof into shoppable moments.

Set up your UGC Media Grid

🎦 Click below to view our interactive guide

Step 1: Connect Instagram account

For Instagram content to sync properly, make sure your Instagram account is a business (professional) account and is connected to a Facebook page.

Then, to connect your Instagram account to Judge.me:

  1. From your Judge.me admin, go to Widgets > UGC Media Grid > Manage.

  2. Click the Connect Instagram account button.

  3. In the UGC Media Grid Settings page, click Continue with Facebook.

  4. Log in and select the Facebook account linked to your Instagram profile.

  5. Grant all required permissions.

  6. Click Activate next to your Instagram account to complete the connection.

Step 2: Publish your posts

After connecting, we will automatically fetch up to 100 of your most recent Instagram posts, including posts you've published and posts where you're tagged.

New content will be updated daily.

To fetch new posts manually:

  • From your Judge.me admin, go to Widgets

  • Scroll down to find the UGC Media Grid card and click Manage.

  • Click the Refresh posts button.

To publish a post:

  1. From your Judge.me admin, go to Widgets

  2. Scroll down to find the UGC Media Grid card and click Manage.

  3. Find the post you want to show on the UGC Media Grid.

  4. Click the Hidden dropdown on the right of the post and select Publish post.

You can also link the post to a specific product:

  • From your Judge.me admin, go to Widgets

  • Scroll down to find the UGC Media Grid card and click Manage.

  • Find the post you want to link and click Link store product.

Step 3: Install the UGC widget

Once you’ve published at least 1 post, follow these steps to install the UGC Media Grid on your storefront.

Note:

The UGC Media Grid will only show when at least 1 post is published.

Customize the UGC Media Grid

To update the look and feel of the UGC Media Grid:

  • From your Judge.me admin, go to Widgets

  • Scroll down to find the UGC Media Grid card and click Manage.

  • Click the Widget settings button.

  • There, you can adjust the following elements:

1. Title and subtitle

To adjust the title and subtitle in the UGC Media Grid:

  • Scroll down to the Design section.

  • Adjust the texts in the fields below to your likings and click Save:

Field

Default texts

Title

Made by us, Shared by you

Subtitle

Tag us to see your picture featured in our page

2. Post timestamp

To show the date of the post in the UGC Media Grid:

  • Scroll down to the Design section.

  • Enable "Show Instagram post timestamp".

  • Click Save.

3. The width of the widget

To adjust the width of the UGC Media Grid:

  • Scroll down to the Design section.

  • Enable "Show Instagram post timestamp".

  • Click Save.

3. The "Buy now" button

To adjust the text, color, and style of the Buy now button in the UGC Media Grid:

  • Scroll down to the Product Image Button section.

  • Customize the button using the following fields:

    • Button text – Change the default "Buy Now" label to match your store’s voice.

    • Button color – Choose the background color of the button.

    • Text color – Set the color of the button text.

    • Button border style – Select a border style (e.g., solid, dashed, none).

    • Button border – Set the thickness of the border (in pixels).

    • Button border radius – Adjust the roundness of the button corners.

    • Border color – Choose the color of the button border if one is applied.

  • Click Save.

4. The "Load more" button

To adjust the text, color, and style of the Load more button in the UGC Media Grid:

  • Scroll down to the Loading button section.

  • Customize the button using the following fields:

    • Button text – Change the default "Load more" label to match your store’s voice.

    • Button color – Choose the background color of the button.

    • Text color – Set the color of the button text.

    • Button border style – Select a border style (e.g., solid, dashed, none).

    • Button border – Set the thickness of the border (in pixels).

    • Button border radius – Adjust the roundness of the button corners.

    • Border color – Choose the color of the button border if one is applied.

  • Click Save.

5. The "View reviews" button

To adjust the text, color, and style of the View reviews button in the UGC Media Grid:

  • Scroll down to the Reviews button section.

  • Customize the button using the following fields:

    • Button text – Change the default "View reviews" label to match your store’s voice.

    • Button color – Choose the background color of the button.

    • Text color – Set the color of the button text.

    • Button border style – Select a border style (e.g., solid, dashed, none).

    • Button border – Set the thickness of the border (in pixels).

    • Button border radius – Adjust the roundness of the button corners.

    • Border color – Choose the color of the button border if one is applied.

  • Click Save.

Troubleshoot


Authentication section stuck on loading

Issue:

In the UGC Media Grid Settings page, instead of the Continue with Facebook button, you only see a loading icon.

Why it happens:

The loading icon in the Authentication section usually indicates one of the following:

  • A network-related issue, such as a blocked third-party script, slow connection, or VPN interference.

  • Browser caching or cookies are preventing proper session handling.

How to fix:

To see the Continue with Facebook button in this case, try the following steps:

  • Hard refresh the page (Windows: Ctrl + Shift + R, Mac: Cmd + Shift + R).

  • Try in incognito/private mode.


Some posts in the UGC Media Grid shows "User picture" error

Issue:

You have added the UGC Media Grid and some posts show the correct content. However, for some other posts, instead of the actual image or video, a broken image icon and the alt text "User picture" appear.

Why it happens:

The User picture error might show on some posts in your UGC Media Grid if we don't have access to the original media—either because:

  • The image or video was deleted or removed from Instagram.

  • The content was made private, restricted, or is no longer available via API.

How to fix:

To remove posts with the User picture error from your UGC Media Grid:

  • From your Judge.me admin, go to Widgets

  • Scroll down to find the UGC Media Grid card and click Manage.

  • Unpublish the affected posts, usually the ones without media.

  • Publish other posts if necessary.


All posts in the UGC Media Grid shows "User picture" error

Issue:

You have added the UGC Media Grid and all posts show a broken image icon and the alt text "User picture" instead of the actual image or video.

Why it happens:

The User picture error might show on all of your posts in the UGC Media Grid if your Instagram account was previously connected, but the connection has now been lost (e.g. access revoked, expired, or disconnected from Facebook). As a result, we can no longer access the media.

How to fix:

To make sure we can fetch the right content, you can go back to Step 1 to reconnect your Instagram account to Judge.me.

Once reconnected, we will resume pulling media for your posts.


Did this answer your question?