# Photos

Photos pulled from online services refresh each time you open the photo list or album so that your app is always up to date.

### Adding the Photos building block <a href="#add" id="add"></a>

1. Click on **+ block**.
2. Select the **Photos** block and click **Add this block**.
3. Choose the data source for your photos:
   * **Manual**: upload photos directly to the AppMachine CMS.
   * **Tumblr**: shows photos from your Tumblr blog.
   * **Flickr**: enter the account username. (1500 photo maximum)
   * **Instagram**: enter the account URL that you want to display in the app.
4. Click **Continue**.
5. Fill in the **name** of the block.<br>

   <figure><img src="/files/7gRDS6zRYalA083GIjUH" alt=""><figcaption></figcaption></figure>
6. Click on the **icon** if you want to change the image used in the menu.
7. When you’re done, click **Add this Block**.

### **Adding Photos to your block** <a href="#configure" id="configure"></a>

1. Under the **Data** tab, click on **+ Add New Item**
2. Add your **Photo**, **Name**, and **Description** (and optionally an **External Image URL**) and click **Save**.

   <figure><img src="/files/0BXVWRpt8hjVJybkn7PG" alt=""><figcaption></figcaption></figure>

   When adding a photo in this screen, you can choose photos from Pexels, Upload your own image, or use an image you've previously used in the app. <br>

   <figure><img src="/files/fhkUOzwdKHdShdbJpnfS" alt=""><figcaption></figcaption></figure>
3. Repeat this process until you've added all of your photos.&#x20;

### **Configuring the Photos building block** <a href="#configure" id="configure"></a>

The **Photos** building block editor is composed of three editing screens; **Data**, **Settings**, and **Design**.

The settings in the **Settings** editing screen determine how your block will function, **Data** allows you maintain the content of the block, and the settings in the **Design** screen determine its aesthetics.&#x20;

#### **Settings**

There are several aspects of your "Photos" block that can be changed in this screen; the name of the block, and the icon (or image) that will be used in the app menu. You can also choose whether you'd like the users to be able to share the events via Twitter, Facebook, or email.<br>

<figure><img src="/files/nNNDnFm89k0AuEibq3tq" alt=""><figcaption></figcaption></figure>

**Photo View** allows you to change the way the photos are displayed in the block.&#x20;

By toggling the **Show Albums** option the block will show a menu with the albums as they are grouped in flickr. If you don't select this option, all photos will appear in a single screen without album distinction.

Should the need arise to keep the users of your published app from using this portion of the app, then you can always make use of the Activated sliding selector.

Slide the selector to **OFF** to keep users from seeing the **Photos** block. Now you can continue developing your app without worrying about users coming upon areas that you haven't finished developing as of yet. Once you are satisfied with your progress, slide the selector back to **ON** to publish this portion of your app.

#### **List**

This is where you add the the questions and answers to your list.

#### **Design**

The **Design** screen allows your to make highly detailed changes to your building block. **Design** gives the developer a remarkable amount of freedom to adjust everything exactly as he or she would like it.

### FAQ

#### How many photos can be uploaded to the Photos block?

You can upload as many photos as you want, but you could also consider to link to an online photo album. The app will become larger (to download in the stores) when you add a large amount of photos.

**How can I create albums in the Photos block?**

This can be accomplished by adding several Photos blocks to a Submenu block.&#x20;


---

# Agent Instructions: 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.appmachine.com/blocks/photos.md?ask=<question>
```

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.
