> For the complete documentation index, see [llms.txt](https://docs.sharinpix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sharinpix.com/documentation/features/user-interface/large-view-toolbar-crop-with-aspect-ratios.md).
# Large View: Toolbar - Crop with Aspect Ratios
SharinPix allows you to crop an image from an album to a specified aspect ratio.
In this article, we will show you how to specify aspect ratios using:
1. [SharinPix Permission Object](#specify-aspect-ratios-using-sharinpix-permission-admin-oriented) (This method is suitable for admins)
2. [SharinPix Parameters](#specify-aspect-ratios-using-sharinpix-parameters-developer-oriented)
To crop an image to a specified aspect ratio, you first need to access the crop Editing mode by:
1\. Clicking on the image to access the large view:
2\. Selecting the **crop** option to activate the Editing mode:
3\. Accessing the **Aspect Ratio** feature from the Editing mode:
{% hint style="success" %}
**Tip:**
For more information about the crop option or the features available in the Editing mode, refer to the previous article or click on the following link: [Large View: Toolbar – Crop](/documentation/features/user-interface/large-view-toolbar-crop.md)
{% endhint %}
{% hint style="warning" %}
**Note:**
The crop option can only be configured by either using a **SharinPix Permission record** or by **code implementation**.
{% endhint %}
## Specify Aspect Ratios Using SharinPix Permission (Admin-Oriented)
Aspect ratios can be easily specified using the SharinPix Permission object (an object allowing users to configure the features to be added or omitted from a SharinPix album).
{% hint style="success" %}
**Tip:**
For more information about the SharinPix Permission object, refer to the following article:
[SharinPix Permission object](/documentation/access-and-security/sharinpix-permission-object-how-to-create-and-assign-custom-permission.md)
{% endhint %}
To specify aspect ratios using SharinPix Permission:
* Create or edit a SharinPix Permission record
* In the **Toolbar** section, check the option **Crop images**. Then, enter the aspect ratios you intend to use in the **Crop ratio** section as demonstrated in the example below:
{% hint style="warning" %}
**Note:**
* The aspect ratios specified in the **Crop ratio** section should be separated by a semi-colon
* The aspect ratios are displayed in the same order as entered in the **Crop ratio** section
* The first value specified in the list will be applied by default when accessing the Aspect Ratio feature from the crop Editing mode
{% endhint %}
* Check the other features you want to apply to the SharinPix album and click save when done
{% hint style="info" %}
In the example above, the aspect ratios specified are **4:3** , **1:1** , **16:9** and **free**.
While the values **4:3**, **1:1** and **16:9** are self-explanatory, the '**free**' value looks foreign. This is because the 'free' value is predefined in SharinPix and it allows users to adjust the crop frame as desired.
{% endhint %}
You can also display labels in the **Aspect Ratio list** available from the **Editing mode** instead of the actual values.
To do so, simply use the following format in the **Crop ratio** section in your **SharinPix Permission r**ecord:
4:3|Banner;1:1|Square;16:9|Landscape;free|Free
The result is depicted in the example below:
## Specify Aspect Ratios Using SharinPix Parameters (Developer-Oriented)
Aspect ratios can also be specified using SharinPix Parameters and subsequently used in a SharinPix album wrapped within a Visualforce Page.
To specify aspect ratios using SharinPix parameters:
* Create an Apex Controller that will define the SharinPix album's parameters (including the part on aspect ratios specification) using the code snippet below:
```apex
public class SharinPixAlbumController {
public String parameters {get; set;}
public SharinPixAlbumController(ApexPages.StandardController stdCtrl) {
Id albumId = stdCtrl.getId();
Map params = new Map {
'abilities' => new Map {
albumId => new Map {
'Access' => new Map {
'see' => true,
'image_list' => true,
'image_upload' => true,
'image_delete' => true
}
}
},
'Id' => albumId,
'crop_ratio' => new List{'4:3','1:1','16.9','free'}
};
parameters = JSON.serialize(params);
}
}
```
{% hint style="warning" %}
**Note:**
* The crop ratio should be added at the **root**
* The aspect ratios should be specified in the following format:
'crop_ratio' => new List{'4:3','1:1','16:9','free'}
{% endhint %}
* Next, implement the Visualforce Page embedding the SharinPix album with the applied parameters using the code snippet below:
{% code fullWidth="false" %}
```apex
```
{% endcode %}
* Finally, add the Visualforce Page to the **Account** record layout so as to test the aspect ratios
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sharinpix.com/documentation/features/user-interface/large-view-toolbar-crop-with-aspect-ratios.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.