Of course. Let's break down pagesize in the context of Dedecms (织梦内容管理系统).

What is pagesize?
In Dedecms, pagesize is a system variable that controls the number of items displayed on a single page when a list of content is paginated. This is a fundamental concept for managing large amounts of content, as it prevents pages from becoming too long and improves website loading speed and user experience.
You can think of it as the "items per page" setting.
Where is pagesize Used?
The pagesize variable is primarily used in two main areas:
- System-Wide Default Setting: This is the fallback value used by most channel lists and search results if a specific
pagesizeis not defined elsewhere. - Specific Channel/Model Setting: You can override the system-wide default for individual content channels (like articles, products, downloads, etc.) or specific models.
System-Wide pagesize Configuration
This is the most common setting you'll need to change. It controls the default number of articles for most lists on your site.

Location in the Admin Panel:
- Log in to your Dedecms admin dashboard.
- Navigate to 系统 (System) -> 系统基本参数 (System Basic Settings).
- On the left menu, click on 核心设置 (Core Settings).
- Scroll down until you find the setting named:
列表每页默认记录数 (Default number of records per page in lists)
How to Change It:
- The default value is often
20or40. - Enter your desired number (e.g.,
15,25,50). - Click the 保存 (Save) button at the bottom.
Important: After changing this setting, you must regenerate your HTML pages for the changes to take effect on the front end. You can do this by going to 生成 (Generate) -> 一键更新网站 (One-click Update Website) and updating the relevant pages (e.g., "主页HTML", "栏目列表").
Screenshot of the setting in the Dedecms admin panel
pagesize for Specific Channels (Categories)
Sometimes you want one category (e.g., "News") to show 10 articles per page, while another category (e.g., "Tutorials") shows 20. You can set this on a per-channel basis.

Location in the Admin Panel:
- Navigate to 频道模型 (Channel Models) -> 内容频道管理 (Content Channel Management).
- Find the channel you want to edit (e.g., "普通文章" - Articles) and click the [修改] button next to it.
- In the channel settings form, look for a field named:
列表每页记录数 (Number of records per page in list)
How to Change It:
- You can leave this field empty to use the system-wide default value you configured in the previous step.
- Or, you can enter a specific number to override the default for this channel only.
- Click 确定 (OK) to save.
pagesize in Template Tags (for Developers)
If you are a theme developer, you might need to control pagesize directly within your DedeCMS template files (.htm files). You can do this by passing the pagesize parameter to the list tag.
The most common list tag is {dede:arclist}.
Example in a Template:
{dede:arclist pagesize='10' titlelen='30'}
<li>
<a href="[field:arcurl/]">[field:title/]</a>
<span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
</li>
{/dede:arclist}
In this example:
pagesize='10'forces this specific list to display 10 articles per page, ignoring both the system-wide default and the channel-specific setting. This is useful for special sections like "Featured Articles" or "Latest News" in your sidebar or homepage.
The same principle applies to other list tags like {dede:list} (used in custom model templates).
Troubleshooting: My pagesize Change Isn't Working!
If you've changed the setting but the number of items on the page hasn't updated, here are the most common reasons and solutions:
-
You Haven't Regenerated HTML Pages: This is the #1 reason. DedeCMS generates static HTML files for performance. Changing a setting in the database doesn't automatically update these files.
- Solution: Go to 生成 (Generate) -> 一键更新网站 (One-click Update Website) and update the necessary pages (e.g., "栏目列表", "主页HTML").
-
A Template Tag is Overriding the Setting: A developer may have hardcoded
pagesize='X'into a template tag on that specific page.- Solution: Check the template file (
.htm) for that page and look for apagesizeparameter in the{dede:arclist}or{dede:list}tag.
- Solution: Check the template file (
-
You Changed the Wrong Setting: You might have changed the channel-specific setting but the page you're viewing uses the system-wide default, or vice-versa.
- Solution: Double-check which setting applies to the page you are viewing. Is it a general channel or a specific one?
Summary
| Setting Location | Scope | How to Access | Priority |
|---|---|---|---|
| System Core Setting | Site-wide default for all channels. | 系统 -> 系统基本参数 -> 核心设置 |
Lowest (Overridden by others) |
| Channel Setting | Specific to one content channel (e.g., Articles). | 频道模型 -> 内容频道管理 -> [修改] |
Medium (Overrides system default) |
| Template Tag | Specific to one list instance on a single page. | Edit the .htm template file directly. |
Highest (Overrides all other settings) |
