> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payreque.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop Setup

> Create and configure your PayRequest shop — the multi-product storefront customers browse at /shop/{yourshop}

# Shop Setup

Your PayRequest shop is a full storefront at `payrequest.app/shop/{yourshop}` where customers can browse multiple products, add them to a cart, and check out in one go — separate from single-product [PayRequest Pages](/shop-and-checkout/product-display). Setup happens in one place: **Shop** in your dashboard sidebar.

<Info>
  Every account can have one shop. Once created, the same page is used to edit settings — there's no separate "shop settings" screen.
</Info>

## How It Works

<Steps>
  <Step title="Choose a shop name">
    Navigate to **Shop** and pick a name. It's automatically lowercased and can only contain lowercase letters, numbers, and hyphens — this becomes your URL: `payrequest.app/shop/your-name`. Names must be unique across all PayRequest shops.
  </Step>

  <Step title="Add a description and default language">
    Set a shop description and pick a default language (English, Dutch, French, or Spanish).
  </Step>

  <Step title="Go live">
    New shops are created offline by default. Flip the **Shop Status** toggle to make it publicly visible and start accepting orders.
  </Step>

  <Step title="Configure branding">
    In the **Branding** tab, upload a logo and set a portal accent color (hex code) that's used across your shop and customer portal.
  </Step>

  <Step title="Set up a custom domain (optional)">
    In the **Custom Domain** tab, point your own domain at the shop. See [Custom Domains](/shop-and-checkout/custom-domains) for DNS steps.
  </Step>

  <Step title="Review shop settings and legal pages">
    Configure tax display, signup, and invoicing behavior in **Shop Settings**, and add Terms & Privacy content in **Legal Pages** if you want to publish your own policies.
  </Step>
</Steps>

## Shop Settings Reference

| Setting | What it does |
| - | - |
| **Shop Status** | Turns the shop online/offline. Offline shops return a "store not found" to visitors. |
| **Allow Signup** | Lets customers create their own login for the customer portal. Turn off to keep checkout guest-only. |
| **Auto Create Invoices** | Automatically generates an invoice for every order placed through the shop. |
| **Allow Invoice Subscriptions** | Permits subscription products to be sold via invoice (not just automatic recurring payment). |
| **Tax Display** | `inclusive` (prices shown include tax) or `exclusive` (tax shown separately at checkout). Applies shop-wide. |
| **Accent Color** | A single hex color used to theme the shop and customer portal. Clear it to fall back to the default theme. |
| **Logo** | Uploaded image (max 10MB), stored on R2 and shown in the shop header. |

<Note>
  Tax display, accent color, and logo also affect the customer portal (order history, invoices, subscriptions) since it shares the same shop branding.
</Note>

## Legal Pages

The **Legal Pages** tab lets you paste in your own Terms of Service and Privacy Policy content, stored per-shop and shown to customers at checkout. Leaving these empty is fine — PayRequest doesn't require them to operate the shop, but publishing your own is good practice, especially alongside [GDPR Compliance](/security-and-compliance/gdpr-compliance) considerations.

## Related Shop Features

Once your shop is live, these are configured separately:

* **Vacation Mode** — pause new orders temporarily. See [Vacation Mode](/shop-and-checkout/vacation-mode).
* **Spam Protection** — block bots and unwanted countries at checkout. See [Spam Protection](/shop-and-checkout/spam-protection).
* **Product Display** — carousel vs. grid layout for your product catalog. See [Product Display Layout](/shop-and-checkout/product-display).

## FAQ

<AccordionGroup>
  <Accordion title="Can I change my shop name after creating it?">
    Yes, from the same **Shop** page — just note the URL changes with it, so update any shared links.
  </Accordion>

  <Accordion title="Can I run more than one shop?">
    No, each PayRequest account has a single shop tied to your user ID. Single-product PayRequest Pages are a separate, unlimited alternative if you need multiple standalone checkout pages.
  </Accordion>

  <Accordion title="What happens to existing orders if I turn the shop offline?">
    Existing orders, invoices, and subscriptions are unaffected — offline only blocks new visitors from reaching the storefront and starting a new checkout.
  </Accordion>

  <Accordion title="Does disabling signup log out existing customers?">
    No. It only hides the option for new customers to register; customers who already have portal accounts can still log in.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Checkout Customization" icon="credit-card" href="/shop-and-checkout/checkout-customization">
    See what customers experience at checkout
  </Card>

  <Card title="Shopping Cart" icon="cart-shopping" href="/shop-and-checkout/shopping-cart">
    How multi-product carts work
  </Card>

  <Card title="Custom Domains" icon="globe" href="/shop-and-checkout/custom-domains">
    Put your shop on your own domain
  </Card>

  <Card title="Vacation Mode" icon="umbrella-beach" href="/shop-and-checkout/vacation-mode">
    Pause orders temporarily
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.