Thread tagged as: Question, Configuration, PayPal

Perch Shop - Not sure what I'm doing

I've gotten as far as adding the products successfully, but I don't know what to do next. How do I get a page that shows my products? Is there sample code that shows me how to do this? I've looked, but I don't see it. I have a shop page ready, but need to know what code I need to put in it to show my products, etc. Can you help me with this? This is my regular shop page, before adding perch: Are there templates I'm supposed to be using or what?? I'm lost.

Kisha Walton

Kisha Walton 0 points

  • 1 year ago
Duncan Revell

Duncan Revell 73 points
Registered Developer


have a look at this page

There's a link to GitHub where the source can be found - it's an excellent demonstration of Shop.

Robert Ketter

Robert Ketter 95 points
Registered Developer


Perch Shop is not your typical shopping cart. Perch Shop puts all the control in your hands, from checkout flow to the exact layout of each and every aspect of your shop.

For this reason, there is limited examples... mostly because each shop will ultimately end up totally different from the next.

Most things in Perch Shop are pretty straight forward. A great example would be perch_shop_cart() shows the "CART", perch_shop_product() shows "A PRODUCT" while perch_shop_products() shows "ALL PRODUCTS."

So most functions in Perch Shop are as simple as... Show me the cart = perch_shop_cart(), Empty the cart = perch_shop_empty_cart().

Every function has a default template (when outputing) then most functions have various custom options. So first taking a look at the Sample Shop as mentioned in previous post then diving into the very simple examples listed on this page should get you up and running.

If additional help is needed then post your template and note where your expecting something to happen and we will help you get off the ground.

Okay, thanks for the info. I was able to get it working. My products are showing up correctly now; however, anytime I press 'add to cart' it gives me this error:

Not Found

The requested URL /shop/cart was not found on this server.

Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.

I put the folder shop/cart into my templates folder. I'm not sure why it keeps saying this. Any idea on what I could be doing wrong?

Here is the page

Robert Ketter

Robert Ketter 95 points
Registered Developer

You don't have a page at

You need to add a page there, are you using Perch or Perch Runway?

I'm using Perch.

Rachel Andrew

Rachel Andrew 391 points
Perch Support

You need to create all of the pages your shop needs.

Start by planning how your shop will work and then use the functions to build out the pages.

There are examples of different things you might want to do here

Shop is more involved than many other apps because there are hundreds of different things people might want a shop to do, so you need to do more work yourself in order that you have that flexibility.