Skip to main content

Add a banner or buttons to your customer portal with Custom HTML

Show your own message, image or button above or below your customer portal, using HTML and CSS.

Custom HTML lets you add your own content to the customer portal: a seasonal offer, a banner image, a button that links to a collection, or a note about shipping times. You paste HTML and CSS into a box in Appstle, and customers see it the next time they open the portal. You don't need to edit your theme.

Availability

Custom HTML is available on every plan. It shows in the customer portal on your online store. If your store uses Shopify's new customer accounts, check Where customers manage subscriptions in your Customer Portal settings: when it's set to Inside Shopify customer accounts, customers don't see your Custom HTML.

Before you start

  • Decide where the content goes. The top box shows it above the portal content, and the bottom box shows it below.

  • Have your HTML and CSS ready. Scripts and Liquid code can't be saved here: see What you can and can't add below.

  • If you want an image, upload it to your store first (Content → Files in Shopify admin) and copy its web address. The recommended image size is 1620 × 269 px.

Add content to your customer portal

  1. In Shopify admin, open Appstle Subscriptions and click Customer Portal.

  2. Click the Custom HTML tab. If you don't see it, click More views first.

  3. Scroll to Customer Portal Top HTML for content above the portal, or Customer Portal Bottom HTML for content below it.

  4. Click inside the code box and paste your HTML and CSS.

  5. Click Save in the bar at the top of the page.

  6. Open your customer portal (usually /apps/subscriptions on your store), signed in as a customer, and reload the page to check the result.

The Customer Portal Top HTML box with a banner pasted in.

If the save is refused, a note under the box says what to remove. See If your HTML doesn't save below.

Start from an example

This is the banner shown in the screenshots. The outer box lines it up with the rest of the portal. Paste it into Customer Portal Top HTML, then change the text, colors and link:

<div style="width:100%; max-width:1280px; margin:16px auto; padding:0 16px; box-sizing:border-box;">
<div style="background:#f3ede4; border-radius:12px; padding:24px 28px; text-align:center;">
<h2 style="margin:0 0 8px; font-size:28px; line-height:1.2;">Thanks for being a subscriber</h2>
<p style="margin:0 0 16px; font-size:16px;">Add our new seasonal roast to your next order.</p>
<a href="/collections/all"
style="display:inline-block; background:#1a1a1a; color:#ffffff;
padding:10px 20px; border-radius:8px; text-decoration:none;">Shop all products</a>
</div>
</div>

The Add simple portal content card at the top of the tab has a Sample HTML and CSS template too. Click Copy code, paste it into a box, and change it to suit your store. Use ChatGPT opens ChatGPT with a ready-made request for a banner, and Use Gemini opens Gemini. Read what they write before you paste it, because the same checks apply.

The Add simple portal content card with the sample template and the Copy code button

The Add simple portal content card, with the sample template and the Copy code button.

What your customers see

Content in the top box shows above the greeting ("Hello" and the customer's name). Content in the bottom box shows at the end of the portal, below the subscription cards. Both stay in place on every page of the portal.

The customer portal with a banner above the greeting

A banner in the top box, above the customer's greeting.

Your CSS decides how the content looks on a phone, so open the portal on a phone or a narrow window before you finish.

The same banner on a phone

The same banner on a phone.

What you can and can't add

Custom HTML takes HTML and CSS. You can add:

  • Text, headings, lists, links and images. For a button, style a link to look like one, as in the example above.

  • Tables, video and audio.

  • Inline styles (style="...") and <style> blocks.

  • Links to pages in your store, such as /collections/all, links to https:// addresses, and email and phone links (mailto: and tel:).

Appstle doesn't save these:

  • Scripts (<script>) and Liquid code ({{ }} or {% %}).

  • Event attributes such as onclick, and links that start with javascript:.

  • Forms and fields (<form>, <input>) and embedded pages (<iframe>, <object>, <embed>).

  • Whole-page tags such as <html>, <head> and <body>.

  • Other tags and attributes that aren't common HTML, such as <link>, <meta> and data- attributes.

If your HTML doesn't save

When your code has something Appstle doesn't accept, nothing is saved, and customers keep seeing the HTML you saved before in both boxes. A message at the top of the page says "Your custom HTML has code that only support can add.", and a note under the box says what to remove. If the note lists several items, remove each one. These are the notes you're most likely to see.

Note under the box

What to do

Remove scripts (<script>) to save this HTML.

Delete the <script> tag and everything inside it. To add a script, contact support.

Remove Liquid code ({{ }} or {% %}) to save this HTML.

Replace the Liquid code with plain text. To add Liquid code, contact support.

Remove event attributes such as onclick to save this HTML.

Delete the attribute. Use a link (<a href="...">) for anything customers should click.

Remove the href address on <a> (use an https:// address) to save this HTML.

Change the link so it starts with https://, or use a path in your store such as /collections/all.

Remove form fields (<form>) to save this HTML.

Delete the form and its fields. Use a button-style link instead.

Remove embedded pages (<iframe>) to save this HTML.

Delete the embedded page.

Remove the <link> element to save this HTML.

Delete the tag or attribute that the note names. Only common HTML tags and attributes can be saved.

Things to know

  • Anyone who opens the portal page sees your content, even before they sign in. Don't put anything in it that only subscribers should see, such as a private discount code.

  • Your theme's fonts and heading sizes apply to your content. To change them, set font-size and font-family in your CSS.

  • To remove your content, clear the box and click Save.

  • If a box already has a script or other code that it no longer accepts, that code keeps working, and you can still edit and save the rest of the box. To change that code, or to add it back after you delete it, contact support.

  • Only Appstle support can add scripts or Liquid code. To ask, click contact support in the Add simple portal content card.

  • Custom HTML adds content. To change the look of the portal itself, use the Custom CSS tab on the same page.

FAQs

Why doesn't my content show in the customer portal?

  • It wasn't saved. Reload the Custom HTML tab. If your code isn't in the box, paste it again and click Save. If a note shows under the box, see If your HTML doesn't save.

  • Customers manage subscriptions inside Shopify customer accounts. Custom HTML shows only in the portal on your online store. Check Where customers manage subscriptions in your Customer Portal settings.

  • It's in the other box. The top box shows above the greeting and the bottom box shows below the subscription cards.

  • Your CSS hides it. Check for display:none or a color that matches the background.

Can I add a tracking script or a chat widget?

Not in these boxes, because scripts can't be saved here. Contact support, and our team can review the script and add it for you. Apps that you add to your theme, such as a chat widget, usually show on the portal page already, because the portal opens inside your theme.

Can I add an image?

Yes. Upload the image to Content → Files in Shopify admin, copy its address, and use it in an <img> tag or as a CSS background. The recommended size is 1620 × 269 px.

Can I show a different banner to different customers?

No. Everyone who opens the portal sees the same top and bottom content, in every language your store offers.

Did this answer your question?